GPU-Prozess-Probleme in IronPDF: Lösungen

Curtis Chau

Updated: 24. April 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # GPU-Prozess-Probleme in IronPDF: Lösungen ```txt [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 dem `IronCefSubprocess.exe` im Runtimes-Ordner verbunden, der 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** Der `IronCefSubprocess.exe` muss Ausführungsberechtigungen 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 laufen. 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: ```csharp // Disables GPU mode to prevent issues with GPU process crashes IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled; ``` 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: ```bash # 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. ``` 3. **Überprüfen Sie auf fehlende DLLs** Wenn die obigen Schritte das Problem nicht lösen, 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](/get-started/ironpdf-docker/) für detaillierte Anweisungen. 4. **Einzelprozessmodus aktivieren** Fügen Sie den folgenden Code hinzu, um IronPDF zu zwingen, im Einzelprozessmodus zu laufen: ```csharp // Forces IronPDF to run in single-process mode to improve stability on Azure IronPdf.Installation.SingleProcess = true; ``` Wenn keine der oben genannten Lösungen das Problem löst, reichen Sie bitte eine [Engineering-Anfrage](/troubleshooting/engineering-request-pdf/) für persönliche Hilfe ein.

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

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

[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 dem IronCefSubprocess.exe im Runtimes-Ordner verbunden, der 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

   Der IronCefSubprocess.exe muss Ausführungsberechtigungen 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 laufen. 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

   C#VB

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.

   SHELL

3. Überprüfen Sie auf fehlende DLLs

   Wenn die obigen Schritte das Problem nicht lösen, 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

   C#VB

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

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 Handbücher.

...

Weiterlesen