# El renderizador de Chrome falla en el inicio en frío en Azure App Service Linux
Este problema ocurre en Azure App Service Linux cuando Azure actualiza la imagen base de Oryx/Ubuntu subyacente, eliminando bibliotecas compartidas de las que depende el renderizador de Chrome de IronPDF. Durante el siguiente inicio en frío, IronPDF debe reinstalar esas dependencias nativas de Chrome desde cero, un proceso que puede tardar hasta 5 minutos. Si el tiempo de espera de inicio de la aplicación es demasiado corto, la instalación se interrumpe y el renderizador falla.
El error generalmente aparece como:
```txt
libnss3.so: cannot open shared object file: No such file or directory
```
Azure actualiza periódicamente la imagen base utilizada por los entornos de App Service Linux. Estas actualizaciones pueden eliminar bibliotecas compartidas como `libnss3.so` que Chrome requiere. Cuando esto sucede, el mecanismo `LinuxAndDockerDependenciesAutoConfig` de IronPDF intenta reinstalar los paquetes necesarios al inicio. Si el tiempo de espera del servicio es más corto que el tiempo necesario para completar esta instalación, el proceso se corta antes de que Chrome esté listo.
Este problema ha sido confirmado en el siguiente entorno:
- **Versión afectada:** IronPDF 2026.4.1
- **Versión no afectada:** IronPDF 2026.5.2
- **Hospedaje:** Plan Azure App Service P0v3, región Noruega Este
- **Tiempo de ejecución:** .NET 10
## Solución
### Solución 1: Aplicar configuraciones de inicialización y aumentar el tiempo de espera de inicio
Agregue el siguiente código de inicialización al inicio de la aplicación, antes de cualquier llamada de renderización de PDF:
```csharp
Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();
```
Configurar `LinuxAndDockerDependenciesAutoConfig` a `true` indica a IronPDF que detecte e instale automáticamente las dependencias faltantes de Linux. Configurar `ChromeGpuMode` a `IronPdf.Engines.Chrome.ChromeGpuModes.Disabled` desactiva la aceleración de GPU, que no está disponible en los entornos de Azure App Service Linux. Habilitar el registro completo ayuda a capturar cualquier error durante el paso de instalación de dependencias.
Luego, aumente el tiempo de espera de inicio de Azure App Service a al menos 10 minutos. Esto le da a IronPDF suficiente tiempo para completar la reinstalación de dependencias durante un inicio en frío después de una actualización de la imagen base de Azure. Consulte la [guía de despliegue de Azure](/get-started/azure/) para obtener instrucciones sobre cómo ajustar la configuración del límite de tiempo de inicio en la configuración de App Service.
### Solución 2: Actualizar a IronPDF 2026.5.2 o posterior
Actualizar a IronPDF 2026.5.2 o una versión posterior resuelve este problema. La versión no afectada maneja el caso en el que las actualizaciones de la imagen base de Azure eliminan bibliotecas compartidas sin causar una falla de inicio en frío.
[[n:(Este problema se resolvió en IronPDF 2026.5.2. Si está en esa versión o posterior, las soluciones alternativas de la Solución 1 ya no son necesarias.)]]
Este problema ocurre en Azure App Service Linux cuando Azure actualiza la imagen base de Oryx/Ubuntu subyacente, eliminando bibliotecas compartidas de las que depende el renderizador de Chrome de IronPDF. Durante el siguiente inicio en frío, IronPDF debe reinstalar esas dependencias nativas de Chrome desde cero, un proceso que puede tardar hasta 5 minutos. Si el tiempo de espera de inicio de la aplicación es demasiado corto, la instalación se interrumpe y el renderizador falla.
El error generalmente aparece como:
libnss3.so: cannot open shared object file: No such file or directory
libnss3.so: cannot open shared object file: No such file or directory
Text
Azure actualiza periódicamente la imagen base utilizada por los entornos de App Service Linux. Estas actualizaciones pueden eliminar bibliotecas compartidas como libnss3.so que Chrome requiere. Cuando esto sucede, el mecanismo LinuxAndDockerDependenciesAutoConfig de IronPDF intenta reinstalar los paquetes necesarios al inicio. Si el tiempo de espera del servicio es más corto que el tiempo necesario para completar esta instalación, el proceso se corta antes de que Chrome esté listo.
Este problema ha sido confirmado en el siguiente entorno:
Versión afectada: IronPDF 2026.4.1
Versión no afectada: IronPDF 2026.5.2
Hospedaje: Plan Azure App Service P0v3, región Noruega Este
Tiempo de ejecución: .NET 10
Solución
Solución 1: Aplicar configuraciones de inicialización y aumentar el tiempo de espera de inicio
Agregue el siguiente código de inicialización al inicio de la aplicación, antes de cualquier llamada de renderización de PDF:
Option Strict On
Option Infer On
Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()
Configurar LinuxAndDockerDependenciesAutoConfig a true indica a IronPDF que detecte e instale automáticamente las dependencias faltantes de Linux. Configurar ChromeGpuMode a IronPdf.Engines.Chrome.ChromeGpuModes.Disabled desactiva la aceleración de GPU, que no está disponible en los entornos de Azure App Service Linux. Habilitar el registro completo ayuda a capturar cualquier error durante el paso de instalación de dependencias.
Luego, aumente el tiempo de espera de inicio de Azure App Service a al menos 10 minutos. Esto le da a IronPDF suficiente tiempo para completar la reinstalación de dependencias durante un inicio en frío después de una actualización de la imagen base de Azure. Consulte la guía de despliegue de Azure para obtener instrucciones sobre cómo ajustar la configuración del límite de tiempo de inicio en la configuración de App Service.
Solución 2: Actualizar a IronPDF 2026.5.2 o posterior
Actualizar a IronPDF 2026.5.2 o una versión posterior resuelve este problema. La versión no afectada maneja el caso en el que las actualizaciones de la imagen base de Azure eliminan bibliotecas compartidas sin causar una falla de inicio en frío.
Importante: Este problema se resolvió en IronPDF 2026.5.2. Si está en esa versión o posterior, las soluciones alternativas de la Solución 1 ya no son necesarias.
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.
