1. IronPDF
  2. Fehlersuche
  3. GPU-Prozess ist nicht verwendbar

GPU Process Issues in IronPDF: Solutions

Curtis Chau
Curtis Chau
Aktualisiert:
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 bekannt dafür, die Anwendung abstürzen zu lassen und ist normalerweise mit der IronCefSubprocess.exe verbunden, die sich im Runtimes-Ordner befindet und eine entscheidende 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

    Die IronCefSubprocess.exe muss Ausführberechtigungen haben, damit IronPDF die ChromePdfRenderer-Klasse 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äß zu funktionieren. 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;
    ' 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 Ausführberechtigungen hat. 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

    Wenn die oben genannten Schritte das Problem nicht lösen, führen Sie IronCefSubprocess.exe manuell aus, um fehlende DLLs zu überprüfen. Das System zeigt ein Fehlerfenster an, das die fehlende DLL identifiziert. Installieren Sie die erforderliche DLL und führen Sie 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;
    ' 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
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 16,154,058 | Version: 2025.11 gerade veröffentlicht