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

GPU-Prozess-Probleme in IronPDF: Lösungen

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 führt bekanntermaßen zum Absturz der Anwendung und hängt in der Regel mit der Datei IronCefSubprocess.exe im Runtimes-Ordner zusammen, die eine wichtige Komponente von IronPDF darstellt.

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 über Ausführungsrechte für IronPDF verfügen, damit die ChromePdfRenderer-Klasse ordnungsgemäß initialisiert werden 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 über Ausführungsrechte 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

    Wenn 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;
    ' 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 19,014,616 | Version: 2026.5 just released
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.