Erros de Inicialização do Vulkan e ANGLE no Docker

Atualizado:junho 9, 2026

Translated

View the article in English

O IronPDF registra um erro de inicialização do Vulkan ou ANGLE em containers Docker, AWS Lambda, Azure App Service, Google Cloud Run e pipelines CI/CD.

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...

O Chrome Embedded Framework (CEF) incorporado do IronPDF tenta renderizar via GPU utilizando Vulkan quando nenhum modo explícito de GPU está configurado. Containers Docker executados sem acesso à GPU ou drivers de exibição não conseguem inicializar o Vulkan, desencadeando este erro. Apesar da mensagem de log, o IronPDF continua a renderizar e produz uma saída PDF válida. O erro é não-bloqueante.

Solução

Desative a renderização em GPU e ative o modo de processo único para impedir a tentativa de inicialização da GPU e suprimir o erro:

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

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

Imports IronPdf

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

$vbLabelText $csharpLabel

Defina essas propriedades antes da primeira chamada para ChromePdfRenderer. Esta configuração é recomendada para todas as implementações Docker onde o acesso à GPU não está disponível.

Para referência completa sobre o setup Docker, veja o guia Docker do IronPDF.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...