IronPDFにおけるChrome依存のトラブルシューティング

Curtis Chau
Curtis Chau
Updated: 2026年9月17日

Google Chromium HTMLレンダラーはIronPDFの"Html To PDF"レンダリングプロセスの重要な部分です。 このレンダラーに必要なバイナリは、IronPDF NuGetパッケージ内で簡単に見つけることができるはずです。 欠如したこのバイナリがプロジェクトフォルダーにないと、次のエラーが発生します:

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.
Text

IronPDFがChrome依存関係を自動的にデプロイできない場合、NuGetを介して手動でプロジェクトに追加する必要があります。 複数の依存関係を追加できます:

ご注意: 後のバージョンのIronPDFでは、必要なバイナリは実行時に使用されるOSに基づいて、プロジェクトフォルダに存在しない場合、NuGetソースから自動的にダウンロードされます。 プロジェクトがインターネットに接続されており、プロジェクトフォルダにRead、Write、Executeの権限があれば成功します。)]

Windowsでは、ターゲットオペレーティングシステムにVisual C++ランタイムがインストールされていることを確認すると良いです。 多くの現代的なアプリケーションはこの重要なオペレーティングシステムのコンポーネントがないと実行できません。

LinuxとDockerの互換性ガイドもあります。

Linux

  • 正しいDockerファイルが使用されていることを確認します。

  • IronPdf.Linux NuGetパッケージをIronPDFの代わりに使用してください。

  • ChromeレンダリングのGPUモードを無効に設定:

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
  • LinuxとDockerの依存関係の自動設定を無効にします:

    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;

MacOS

  • .NETランタイムが正しいアーキテクチャに設定されていることを確認します - x64またはarm64。

これで解決しない場合はどうすればよいでしょうか?

これで問題が解決しない場合、私たちはお手伝いします。互換性は私たちのエンジニアリングチームにとって最優先です。 バグレポートはsupport@ironsoftware.comまでメールで送信してください。 すべての互換性問題は、熟練したエンジニアによって徹底的にレビューされます。

特にAWSやAzureのようなクラウドプラットフォームを使っている場合、デプロイするオペレーティングシステム/プラットフォームを必ずお知らせください。

IronPDFでネイティブロギングを有効にする方法

Attaching log files to a bug report more than doubles the probability that we can isolate the issue and solve it rapidly.

次のコードを実行する前に、コードの一番上にこれを置いてください(2021.3.1以降のすべてのバージョン):

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

IronPDFによって作成されたログファイルは、DLLがデプロイされたプロジェクトの/binディレクトリにあります:

  • default.log(デプロイメントプロセス)
  • cef.log(レンダリング)
  • IronSoftwareCefSubprocess.log(レンダリング & スレッディング)
  • IronSoftwareEngine.log ("PDFの生成中にエラーが..."で始まる例外のデバッグに役立ちます)

クラウドサーバーにはしばしばログファイルのための特定の場所があります。 私たちは、AzureおよびAWSでのログファイル生成のガイドを持っています。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

詳しく読む

準備はできましたか?

Nuget Downloads 21,916,531バージョン:2026.11リリースされたばかり