# Problemas del proceso GPU en IronPDF: Soluciones
```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.
```
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:
```csharp
// Disables GPU mode to prevent issues with GPU process crashes
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
```
2. **Conceder Permisos de Ejecución**
Asegúrese de que `IronCefSubprocess.exe` tenga permisos de ejecución. Para sistemas Linux, utiliza el siguiente comando:
```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. **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](/get-started/ironpdf-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:
```csharp
// Forces IronPDF to run in single-process mode to improve stability on Azure
IronPdf.Installation.SingleProcess = true;
```
### 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:
```csharp
// Recommended configuration for cloud PDF generation pipelines in Spain
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.SingleProcess = true;
```
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](/troubleshooting/engineering-request-pdf/) para ayuda personalizada.
## Preguntas frecuentes sobre GPU process en pipelines españoles
**¿Debo deshabilitar el modo GPU para generar PDFs VERI*FACTU 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.
[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.
Text
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:
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.
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 crashesIronPdf.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 crashesIronPdf.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
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.exechmod 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, 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:
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 AzureIronPdf.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 AzureIronPdf.Installation.SingleProcess = True
' Forces IronPDF to run in single-process mode to improve stability on Azure
IronPdf.Installation.SingleProcess = True
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 SpainIronPdf.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 SpainIronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.DisabledIronPdf.Installation.SingleProcess = True
' Recommended configuration for cloud PDF generation pipelines in Spain
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
IronPdf.Installation.SingleProcess = True
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 VERI*FACTU 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 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 estructurados y visualmente atractivos.
