Erreurs d'initialisation Vulkan et ANGLE dans Docker

Mis à jour:9 juin 2026

Translated

View the article in English

IronPDF journalise une erreur d'initialisation Vulkan ou ANGLE dans les conteneurs Docker, AWS Lambda, Azure App Service, Google Cloud Run, et les 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...

Le Chromium Embedded Framework (CEF) embarqué d'IronPDF tente un rendu GPU via Vulkan lorsqu'aucun mode GPU explicite n'est configuré. Les conteneurs Docker s'exécutant sans accès GPU ou pilotes d'affichage ne peuvent pas initialiser Vulkan, déclenchant cette erreur. Malgré le message de journal, IronPDF continue de rendre et produit une sortie PDF valide. L'erreur n'est pas bloquante.

Solution

Désactivez le rendu GPU et activez le mode processus unique pour éviter la tentative d'initialisation GPU et supprimer l'erreur :

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

Définissez ces propriétés avant le premier appel à ChromePdfRenderer. Cette configuration est recommandée pour tous les déploiements Docker où l'accès GPU est indisponible.

Pour la référence complète d'installation Docker, voir le guide Docker IronPDF.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Prêt à commencer ?

Nuget Téléchargements 20,088,359 | Version : 2026.7 vient de sortir