1. IronPDF
  2. Fehlersuche
  3. Vulkan- und ANGLE-Initialisierungsfehler in Docker

Vulkan und ANGLE Initialisierungsfehler in Docker

Curtis Chau
Curtis Chau
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF protokolliert einen Vulkan- oder ANGLE-Initialisierungsfehler in Docker-Containern, AWS Lambda, Azure App Service, Google Cloud Run und CI/CD-Pipelines.

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

Das eingebettete Chrome Embedded Framework (CEF) von IronPDF versucht ein GPU-Rendering über Vulkan durchzuführen, wenn kein expliziter GPU-Modus konfiguriert ist. Docker-Container, die ohne GPU-Zugriff oder Grafiktreiber laufen, können Vulkan nicht initialisieren, was diesen Fehler auslöst. Ungeachtet der Protokollmeldung rendert IronPDF weiter und erzeugt gültigen PDF-Output. Der Fehler ist nicht blockierend.

Lösung

Deaktivieren Sie das GPU-Rendering und aktivieren Sie den Einprozessor-Modus, um den GPU-Initialisierungsversuch zu verhindern und den Fehler zu unterdrücken:

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

Setzen Sie diese Eigenschaften vor dem ersten Aufruf von ChromePdfRenderer. Diese Konfiguration wird für alle Docker-Bereitstellungen empfohlen, bei denen GPU-Zugriff nicht verfügbar ist.

Für die vollständige Docker-Setup-Referenz siehe den IronPDF Docker-Leitfaden.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 20,088,359 | Version: 2026.7 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.