Problemy z procesorem GPU w IronPDF: Rozwiązania

Zaktualizowano:20 sierpnia, 2025

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.

Jeśli podczas używania IronPDF, zwłaszcza przy wdrażaniu na Azure, pojawia się błąd podobny do powyższego, nie jesteś sam. Ten błąd jest znany z awarii aplikacji i zwykle związany jest z IronCefSubprocess.exe znajdującym się w folderze runtimes, który jest kluczowym elementem IronPDF.

Możliwe przyczyny

Kilka czynników może prowadzić do tego błędu procesu GPU. Poniżej znajdują się niektóre z najczęstszych przyczyn:

Brak uprawnień do wykonywania dla IronCefSubprocess

IronCefSubprocess.exe musi mieć uprawnienia do wykonywania, aby IronPDF mógł poprawnie zainicjować klasę ChromePdfRenderer.
Nieprawidłowe kroki wdrożeniowe Azure

Procesy wdrażania dla IronPDF różnią się między Linux a Windows na Azure. Postępowanie zgodnie z niewłaściwymi krokami może wywołać ten błąd.
Brakujące zależności DLL

IronCefSubprocess.exe wymaga określonych plików DLL, aby działać poprawnie. Brakujące pliki DLL, zwłaszcza w środowiskach innych niż Windows, mogą spowodować awarię procesu.

Rozwiązanie

Środowisko lokalne

Jeśli napotykasz ten błąd lokalnie, spróbuj następujących kroków:

Wyłącz tryb GPU

Dodaj następującą linię do swojego kodu, aby wyłączyć tryb GPU dla IronPDF:

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

Przyznaj uprawnienia do wykonywania

Upewnij się, że IronCefSubprocess.exe ma uprawnienia do wykonywania. Dla systemów Linux użyj następującej komendy:

# 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

Sprawdź brakujące pliki DLL

Jeśli powyższe kroki nie rozwiążą problemu, ręcznie uruchom IronCefSubprocess.exe, aby sprawdzić brakujące pliki DLL. System wyświetli okno błędu z identyfikacją brakującego pliku DLL. Zainstaluj wymagany plik DLL i ponownie uruchom aplikację.

Wdrożenie na Azure

Jeśli błąd wystąpi po wdrożeniu aplikacji na Azure, postępuj zgodnie z tymi krokami:

Użyj ZipDeploy

Wdróż swoją aplikację za pomocą ZipDeploy, aby upewnić się, że wszystkie pliki są poprawnie zapakowane.
Odznacz opcję Run From Package File

Upewnij się, że opcja Run From Package File jest odznaczona podczas wdrażania.
Kontejneruj dla Linux

Jeśli Twoja aplikacja jest skierowana na środowisko Linux, rozważ jej kontenerowanie za pomocą Docker przed wdrożeniem na Azure. Zapoznaj się z Przewodnikiem po Dockerze dla szczegółowych instrukcji.

Włącz tryb jednego procesu

Dodaj poniższy kod, aby wymusić działanie IronPDF w trybie jednego procesu:

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

Jeśli żadne z powyższych rozwiązań nie rozwiążą problemu, proszę przesłać Zapytanie do Inżynierów o pomoc osobistą.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released