GPU-Prozess-Probleme in IronPDF: Lösungen

This article was translated from English: Does it need improvement?
Translated
View the article in English
[0110/094441.173:ERROR:network_service_instance_impl.cc(521)] Network service crashed, restarting service.
[0110/094442.261:ERROR:gpu_process_host.cc(990)] GPU process exited unexpectedly: exit_code=255
[0110/094442.261:WARNING:gpu_process_host.cc(1337)] The GPU process has crashed 3 time(s)
[0110/094442.261:FATAL:gpu_data_manager_impl_private.cc(440)] GPU process isn't usable. Goodbye.

Wenn Sie einen ähnlichen Fehler wie oben beschrieben bei der Verwendung von IronPDF sehen, insbesondere bei der Bereitstellung auf Azure, sind Sie nicht allein. Dieser Fehler ist dafür bekannt, dass er zum Absturz der Anwendung führt und steht in der Regel im Zusammenhang mit dem IronCefSubprocess.exe im Ordner runtimes, der eine wichtige Komponente von IronPDF ist.

Mögliche Ursachen

Mehrere Faktoren können zu diesem GPU-Prozessfehler führen. Unten sind einige der häufigsten Ursachen aufgeführt:

  1. Fehlende Ausführberechtigungen für IronCefSubprocess

    Der IronCefSubprocess.exe muss über Ausführungsberechtigungen verfügen, damit IronPDF die Klasse ChromePdfRenderer ordnungsgemäß initialisieren kann.

  2. Falsche Azure-Bereitstellungsschritte

    Bereitstellungsprozesse für IronPDF unterscheiden sich zwischen Linux und Windows in Azure. Das Befolgen der falschen Schritte kann diesen Fehler auslösen.

  3. Fehlende DLL-Abhängigkeiten

    IronCefSubprocess.exe benötigt bestimmte DLL-Dateien, um ordnungsgemäß ausgeführt zu werden. Fehlende DLLs, insbesondere in Nicht-Windows-Umgebungen, können dazu führen, dass der Prozess fehlschlägt.

Lösung

Lokale Umgebung

Wenn Sie diesen Fehler lokal feststellen, versuchen Sie die folgenden Schritte:

  1. Deaktivieren Sie den GPU-Modus

    Fügen Sie die folgende Zeile zu Ihrem Code hinzu, um den GPU-Modus für IronPDF zu deaktivieren:

    // Disables GPU mode to prevent issues with GPU process crashes
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    // Disables GPU mode to prevent issues with GPU process crashes
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    $vbLabelText   $csharpLabel
  2. Erteilen Sie Ausführberechtigungen

    Stellen Sie sicher, dass IronCefSubprocess.exe über Ausführungsberechtigungen verfügt. Für Linux-Systeme verwenden Sie den folgenden Befehl:

    # Grants execute permissions to IronCefSubprocess.exe
    chmod 755 IronCefSubprocess 
    # You may need to specify an exact path
    # IronCefSubprocess is typically found at bin/runtimes/linux-x64/
    # chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess
    # In some cases you may need to use chmod 777 for broader permissions.
    # Grants execute permissions to IronCefSubprocess.exe
    chmod 755 IronCefSubprocess 
    # You may need to specify an exact path
    # IronCefSubprocess is typically found at bin/runtimes/linux-x64/
    # chmod 755 /bin/runtimes/linux-x64/native/IronCefSubprocess
    # In some cases you may need to use chmod 777 for broader permissions.
    SHELL
  3. Überprüfen Sie auf fehlende DLLs

    Falls die oben genannten Schritte das Problem nicht beheben, führen Sie IronCefSubprocess.exe manuell aus, um nach fehlenden DLLs zu suchen. Das System zeigt ein Fehlerfenster an, das die fehlende DLL identifiziert. Installiere die erforderliche DLL und führe die Anwendung erneut aus.

Azure-Bereitstellung

Wenn der Fehler nach der Bereitstellung Ihrer App in Azure auftritt, gehen Sie wie folgt vor:

  1. Verwenden Sie ZipDeploy

    Stellen Sie Ihre Anwendung mit ZipDeploy bereit, um sicherzustellen, dass alle Dateien korrekt gepackt sind.

  2. Deaktivieren Sie Ausführen aus Paketdatei

    Stellen Sie sicher, dass die Option Ausführen aus Paketdatei während der Bereitstellung deaktiviert ist.

  3. Containerisieren Sie für Linux

    Wenn Ihre Anwendung auf eine Linux-Umgebung abzielt, sollten Sie in Betracht ziehen, sie mit Docker zu containerisieren, bevor Sie sie auf Azure bereitstellen. Verweisen Sie auf den Docker-Setup-Leitfaden für detaillierte Anweisungen.

  4. Einzelprozessmodus aktivieren

    Fügen Sie den folgenden Code hinzu, um IronPDF zu zwingen, im Einzelprozessmodus zu laufen:

    // Forces IronPDF to run in single-process mode to improve stability on Azure
    IronPdf.Installation.SingleProcess = true;
    // Forces IronPDF to run in single-process mode to improve stability on Azure
    IronPdf.Installation.SingleProcess = true;
    $vbLabelText   $csharpLabel

Wenn keine der oben genannten Lösungen das Problem löst, reichen Sie bitte eine Engineering-Anfrage für persönliche Hilfe ein.

Curtis Chau
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 17,803,474 | Version: 2026.3 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.