1. IronPDF
  2. Solución de Problemas
  3. El proceso de GPU no es utilizable

Problemas del proceso GPU en IronPDF: Soluciones

Curtis Chau
Curtis Chau
Actualizado:
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.

Si ves un error similar al anterior mientras usas IronPDF, especialmente al desplegar en Azure, no estás solo. Este error es conocido por causar que la aplicación falle y generalmente está relacionado con el IronCefSubprocess.exe ubicado en la carpeta de runtimes, que es un componente crucial de IronPDF.

Para equipos de facturación electrónica española: Este error es habitual en despliegues en la nube de servicios que generan PDFs representativos para VERI*FACTU o procesamiento de lotes SII de la AEAT. Aparece con frecuencia en Azure App Service (Linux) y en AWS eu-south-2 Madrid con ECS/Lambda. La solución más sencilla y recomendada para pipelines de producción es deshabilitar el modo GPU, ya que los PDFs de facturación electrónica no requieren aceleración gráfica.

Posibles causas

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

  1. Falta de permisos de ejecución para IronCefSubprocess

    El IronCefSubprocess.exe debe tener permisos de ejecución para que IronPDF inicialice la clase ChromePdfRenderer correctamente.

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

  3. 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:

  1. 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;
    ' Disables GPU mode to prevent issues with GPU process crashes
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
    $vbLabelText   $csharpLabel

  2. Conceder Permisos de Ejecución

    Asegúrese 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

  3. Verificar por DLL faltantes

    Si los pasos anteriores no resuelven el problema, ejecute manualmente IronCefSubprocess.exe para verificar la falta de DLLs. 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:

  1. Usar ZipDeploy

    Despliega tu aplicación usando ZipDeploy para asegurarte de que todos los archivos estén empaquetados correctamente.

  2. Desmarcar Ejecutar Desde Archivo de Paquete

    Asegúrate de que la opción Ejecutar Desde Archivo de Paquete esté desmarcada durante el despliegue.

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

  4. 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;
    ' Forces IronPDF to run in single-process mode to improve stability on Azure
IronPdf.Installation.SingleProcess = True
    $vbLabelText   $csharpLabel

Despliegues en AWS eu-south-2 Madrid para Facturae y SII

Para pipelines de generación de PDFs que procesan Facturae para FACe o lotes del SII AEAT en AWS eu-south-2 Madrid, la configuración recomendada es:

// Recommended configuration for cloud PDF generation pipelines in Spain
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.SingleProcess = true;
// Recommended configuration for cloud PDF generation pipelines in Spain
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.SingleProcess = true;
' Recommended configuration for cloud PDF generation pipelines in Spain
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
IronPdf.Installation.SingleProcess = True
$vbLabelText   $csharpLabel

Esta combinación elimina la dependencia de GPU y es adecuada para contenedores Docker en ECS Fargate o Lambda que generan PDFs representativos para VERI*FACTU o facturas TicketBAI (Bizkaia, Gipuzkoa, Araba) sin necesidad de hardware gráfico.

Para entornos ENS Medio o ENS Alto en el sector público español que usan Linux en la nube, esta configuración también cumple con los requisitos de proceso aislado habituales en configuraciones de seguridad reforzada.

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

Preguntas frecuentes sobre GPU process en pipelines españoles

*¿Debo deshabilitar el modo GPU para generar PDFs VERIFACTU en la nube?*
Sí, para servicios en la nube que generan PDFs representativos VERI\FACTU o Facturae, deshabilitar el modo GPU (ChromeGpuModes.Disabled) es la práctica recomendada. Los entornos de servidor y contenedor típicamente no tienen GPU disponible, y la generación de PDFs de facturación no requiere aceleración gráfica.

¿Este error afecta a los microservicios TicketBAI desplegados en Linux?
Sí. Los microservicios Linux que generan PDFs para TicketBAI en los territorios forales (Bizkaia, Gipuzkoa, Araba) pueden experimentar este error en contenedores sin GPU. La solución de deshabilitar GPU mode y activar SingleProcess = true es aplicable en todos los entornos Linux, independientemente del proveedor de nube.

Curtis Chau
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 ...

Leer más
¿Listo para empezar?
Nuget Descargas 19,014,616 | Versión: 2026.5 just released
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.