El renderizador de Chrome falla en el inicio en frío en Azure App Service Linux

Actualizado:9 de junio de 2026

Translated

View the article in English

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

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:

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();

Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();

Option Strict On



Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()

$vbLabelText $csharpLabel

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.

ImportanteEste 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

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 20,088,359 | Versión: 2026.7 recién publicada