Problemas del proceso GPU en IronPDF: Soluciones

Actualizado:agosto 20, 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.

Si ves un error similar al anterior mientras usas IronPDF, especialmente al desplegar en Azure, no estás solo. Se sabe que este error causa el bloqueo de la aplicación y generalmente está relacionado con el IronCefSubprocess.exe ubicado en la carpeta de runtime, que es un componente crucial de IronPDF.

Posibles causas

Varios factores pueden llevar a este error de proceso GPU. A continuación, algunas causas frecuentes:

Falta de permisos de ejecución para IronCefSubprocess
El IronCefSubprocess.exe debe tener permisos de ejecución para que IronPDF inicialice correctamente la clase ChromePdfRenderer.
Pasos incorrectos de despliegue en Azure
Los procesos de despliegue para IronPDF difieren entre Linux y Windows en Azure. Seguir los pasos incorrectos puede desencadenar este error.
Dependencias DLL faltantes
IronCefSubprocess.exe requiere ciertos archivos DLL para funcionar correctamente. Las DLL faltantes, particularmente en entornos no Windows, pueden provocar que el proceso falle.

Solución

Entorno local

Si encuentras este error localmente, intenta los siguientes pasos:

Desactivar Modo GPU

Añade la siguiente línea a tu código para desactivar el modo GPU para 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;

$vbLabelText $csharpLabel

Conceder Permisos de Ejecución

Asegúrate de que IronCefSubprocess.exe tenga permisos de ejecución. Para sistemas Linux, utiliza el siguiente comando:

# 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

Verificar por DLL faltantes
Si los pasos anteriores no resuelven el problema, ejecuta manualmente IronCefSubprocess.exe para verificar por DLL faltantes. El sistema mostrará un cuadro de error identificando la DLL faltante. Instala la DLL requerida y vuelve a ejecutar la aplicación.

Implantación de Azure

Si el error ocurre después de desplegar tu aplicación en Azure, sigue estos pasos:

Usar ZipDeploy
Despliega tu aplicación usando ZipDeploy para asegurarte de que todos los archivos estén empaquetados correctamente.
Desmarcar Ejecutar Desde Archivo de Paquete
Asegúrate de que la opción Ejecutar Desde Archivo de Paquete esté desmarcada durante el despliegue.
Containerizar para Linux
Si tu aplicación está dirigida a un entorno Linux, considera containerizarla usando Docker antes de desplegarla en Azure. Consulta la Guía de Configuración de Docker para instrucciones detalladas.

Habilitar el Modo de Proceso Único

Añade el siguiente código para forzar a IronPDF a ejecutarse en modo de proceso único:

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

Si ninguna de las soluciones anteriores resuelve el problema, por favor envía una Solicitud de Ingeniería para ayuda personalizada.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

¿Listo para empezar?

Nuget Descargas 17,012,929 | Versión: 2025.12 recién lanzado

Ver Licencias