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嵌入式框架（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指南。