IronPdfにおけるGPUプロセスの問題:解決策
[0110/094441.173:ERROR:network_service_instance_impl.cc(521)] Network service crashed, restarting service.
[0110/094442.261:ERROR:gpu_process_host.cc(990)] GPU process exited unexpectedly: exit_code=255
[0110/094442.261:WARNING:gpu_process_host.cc(1337)] The GPU process has crashed 3 time(s)
[0110/094442.261:FATAL:gpu_data_manager_impl_private.cc(440)] GPU process isn't usable. Goodbye.
Azure でデプロイする際に特に IronPDF を使用しているときに、上記のようなエラーが表示される場合、あなたは一人ではありません。 このエラーはアプリケーションをクラッシュさせることが知られており、通常はIronPDFの重要なコンポーネントであるランタイム フォルダーにある IronCefSubprocess.exe に関連しています。
考えられる原因
この GPU プロセスエラーは、いくつかの要因で発生します。 以下は最も頻繁に見られる原因です。
-
IronCefSubprocess の実行権限がない
IronPDF が
ChromePdfRendererクラスを適切に初期化するには、IronCefSubprocess.exeに実行権限が必要です。 -
Azure デプロイ手順の誤り
Azure での IronPDF のデプロイプロセスは、Linux と Windows で異なります。 間違った手順を踏むと、このエラーが発生することがあります。
-
DLL 依存関係の不足
IronCefSubprocess.exeを正常に実行するには特定の DLL ファイルが必要です。 DLL が不足していると、特に非 Windows 環境ではプロセスが失敗する原因となります。
解決策
ローカル環境
このエラーがローカルで発生している場合は、次の手順をお試しください。
-
GPU モードの無効化
次の行をコードに追加して、IronPDF の GPU モードを無効にします。
// Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;// Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;' Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled$vbLabelText $csharpLabel -
実行権限の付与
IronCefSubprocess.exeに実行権限があることを確認してください。 Linux システムでは、以下のコマンドを使用します。# Grants execute permissions to IronCefSubprocess.exe chmod 755 IronCefSubprocess # You may need to specify an exact path # IronCefSubprocess is typically found at bin/runtimes/linux-x64/ # chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess # In some cases you may need to use chmod 777 for broader permissions.# Grants execute permissions to IronCefSubprocess.exe chmod 755 IronCefSubprocess # You may need to specify an exact path # IronCefSubprocess is typically found at bin/runtimes/linux-x64/ # chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess # In some cases you may need to use chmod 777 for broader permissions.SHELL -
DLL の不足を確認
上記の手順で問題が解決しない場合は、手動で
IronCefSubprocess.exeを実行して、不足している DLL がないか確認してください。 システムは不足している DLL を特定するエラーボックスを表示します。 必要な DLL をインストールしてアプリケーションを再実行します。
Azure デプロイ
アプリを Azure にデプロイした後にエラーが発生した場合は、次の手順を行います。
-
ZipDeploy の使用
すべてのファイルが正しくパッケージ化されるように ZipDeploy を使用してアプリケーションをデプロイします。
-
パッケージファイルから実行のチェック解除
デプロイ中にパッケージファイルから実行オプションがチェック解除されていることを確認します。
-
Linux 用のコンテナ化
アプリケーションが Linux 環境を対象としている場合、Azure にデプロイする前に Docker を使用してコンテナ化することを検討してください。 Docker セットアップガイド を参照して詳細な手順を確認してください。
-
シングルプロセスモードの有効化
IronPDF をシングルプロセスモードで実行するようにするために次のコードを追加します。
// Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = true;// Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = true;' Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = True$vbLabelText $csharpLabel
上記のどの解決策でも問題が解決しない場合は、個別の支援が必要な場合はエンジニアリングリクエストを提出してください。

