DockerでのVulkanおよびANGLE初期化のエラー

更新日:2026年6月9日

Translated

View the article in English

IronPDFは、Dockerコンテナ、AWS Lambda、Azure App Service、Google Cloud Run、CI/CDパイプラインでVulkanまたはANGLE初期化エラーをログ記録します。

ERR: Display.cpp:1021 (initialize): ANGLE Display::initialize error 0: Internal Vulkan error (-3): Initialization of an object could not be completed for implementation-specific reasons...

IronPDFの埋め込みChrome Embedded Framework (CEF) は、明示的なGPUモードが設定されていない場合、Vulkan経由でGPUレンダリングを試みます。 GPUアクセスやディスプレイドライバがない状態で実行されるDockerコンテナでは、Vulkanを初期化できずにこのエラーが発生します。ログメッセージにもかかわらず、IronPDF はレンダリングを続け、有効な PDF 出力を生成します。このエラーは非ブロッキングです。

解決策

GPU の初期化試行を防ぎ、エラーを抑制するために GPU レンダリングを無効化し、シングルプロセスモードを有効化してください。

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = true;

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = true;

Imports IronPdf

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = True

$vbLabelText $csharpLabel

最初のChromePdfRenderer呼び出しの前にこれらのプロパティを設定してください。 GPU アクセスが利用できないすべての Docker デプロイメントにこの設定をお勧めします。

Docker セットアップの完全なリファレンスについては、IronPDF Docker ガイドを参照してください。

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

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

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？

Nuget ダウンロード 20,088,359 | バージョン: 2026.7 リリースされたばかり