Fallo al iniciar IronPDF con WEBSITE_RUN_FROM_PACKAGE
IronPDF puede fallar al iniciarse en Azure App Service y Azure Functions cuando la aplicación se despliega con WEBSITE_RUN_FROM_PACKAGE = 1. Esa configuración monta la raíz de la aplicación (C:\home\site\wwwroot) como un sistema de archivos de paquete de solo lectura, y el escaneo del sistema de archivos de inicio de IronPDF falla contra él, generalmente en la primera llamada de IronPDF, como al establecer la clave de licencia o al conectarse a un motor remoto.
System.IO.FileNotFoundException
El escaneo no es algo que IronPDF requiera intencionalmente. Es un efecto secundario de la carga automática de extensiones predeterminadas de Ninject. Debido a que C:\home\site\wwwroot es de solo lectura bajo WEBSITE_RUN_FROM_PACKAGE = 1, el escaneo lanza FileNotFoundException y la inicialización se detiene antes de que se realice cualquier trabajo PDF.
Esto se arregla en IronPDF 2026.8.1. Las versiones anteriores se ven afectadas, incluyendo 2026.7.0.2, 2025.12.2, y 2025.3.6 en Windows (win-x64) bajo .NET 10.
Solución
El paso que necesita depende de si ejecuta el motor remoto IronPdfEngine o el IronPDF nativo.
Motor remoto IronPdfEngine y IronPdf.Slim
Actualice a IronPDF 2026.8.1 o posterior. El escaneo de inicio ya no lanza, por lo que WEBSITE_RUN_FROM_PACKAGE = 1 puede permanecer habilitado y no se requiere ningún otro cambio. La representación ocurre en el motor, por lo que no se necesita extraer binarios nativos en la raíz de la aplicación de solo lectura.
Consulte Usar IronPDF con modo en motor para configurar la conexión.
IronPDF nativo
Aquí solo actualizar no es suficiente. Al iniciar, IronPDF nativo extrae los binarios del renderizador Chrome y las bibliotecas de tiempo de ejecución a una ubicación escribible, y un C:\home\site\wwwroot de solo lectura bloquea esa extracción independientemente del error de escaneo mencionado.
En sus configuraciones de Azure App, configure lo siguiente y luego vuelva a implementar:
WEBSITE_RUN_FROM_PACKAGE = 0
¿Desplegando desde Visual Studio? Desmarque Ejecutar desde archivo de paquete (recomendado) durante el paso de publicación.

- Dependiendo de su canal de despliegue, esta configuración se puede aplicar desde varios lugares diferentes. Encuentre dónde está definida y dónde puede ser sobrescrita.
- Para aplicar el cambio: se debe volver a implementar. La configuración sola no tiene efecto hasta que la aplicación se vuelva a implementar.
Reubicar las rutas escribibles
Desde 2026.8.1, cuando el motor nativo no puede desplegar sus binarios Chromium y PDFium en un sistema de archivos de solo lectura, el error de despliegue nombra la causa y los remedios disponibles en lugar de mostrar un fallo poco claro. Uno de esos remedios es apuntar las rutas escribibles de IronPDF a un lugar fuera del montaje del paquete:
IronPdf.Installation.TempFolderPath = @"D:\home\data\ironsoftware\";
IronPdf.Installation.CustomDeploymentDirectory = @"D:\home\data\ironsoftware\";IronPdf.Installation.TempFolderPath = "D:\home\data\ironsoftware\"
IronPdf.Installation.CustomDeploymentDirectory = "D:\home\data\ironsoftware\"IronPdf.Installation.TempFolderPath = "D:\home\data\ironsoftware\"
IronPdf.Installation.CustomDeploymentDirectory = "D:\home\data\ironsoftware\"En Linux App Service, use /home/data/ironsoftware/ en su lugar. Establece estos antes de la primera llamada a IronPDF. Si el renderizador todavía falla al desplegarse, configure WEBSITE_RUN_FROM_PACKAGE = 0 como se describió anteriormente.
Si no puedes actualizar
En versiones anteriores a 2026.8.1, WEBSITE_RUN_FROM_PACKAGE = 0 es la única solución confiable tanto para el motor nativo como para el motor remoto, porque el escaneo de inicio se ejecuta antes de que se alcance cualquiera de los caminos de código.
Para más antecedentes, consulte la guía de WEBSITE_RUN_FROM_PACKAGE de Azure Linux.
Soluciones alternativas que no funcionan en versiones afectadas
Estos se probaron en versiones anteriores a 2026.8.1, donde el escaneo se ejecuta antes que todo lo demás:
- Moviendo la primera llamada de IronPDF fuera del inicio: el fallo aún ocurre en el primer uso desde un punto final bajo demanda.
- Cambiando entre
WEBSITE_RUN_FROM_ZIPyWEBSITE_RUN_FROM_PACKAGE: ambos montajes son de solo lectura y fallan de la misma manera. - Usando el motor remoto
IronPdfEngine: el escaneo de inicio sigue ejecutándose primero, por lo que falla antes de que se use la conexión remota. Este es el comportamiento específico que2026.8.1soluciona. - Configurando
Installation.TempFolderPatha una ruta escribible: el fallo ocurre antes de que se lea esa configuración. Desde2026.8.1, la configuración se lee normalmente.
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.