Incident de démarrage d'IronPDF avec WEBSITE_RUN_FROM_PACKAGE

Curtis Chau
Curtis Chau
Mis à jour : 31 août 2026

IronPDF peut planter au démarrage sur Azure App Service et Azure Functions lorsque l'application est déployée avec WEBSITE_RUN_FROM_PACKAGE = 1. Ce paramètre monte la racine de l'application (C:\home\site\wwwroot) en tant que système de fichiers de paquet en lecture seule, et l'analyse du système de fichiers au démarrage d'IronPDF échoue, généralement lors du premier appel IronPDF tel que la définition de la clé de licence ou la connexion à un moteur distant.

System.IO.FileNotFoundException
Text

L'analyse n'est pas quelque chose qu'IronPDF exige intentionnellement. C'est un effet secondaire du chargement automatique de l'extension par défaut de Ninject. Étant donné que C:\home\site\wwwroot est en lecture seule sous WEBSITE_RUN_FROM_PACKAGE = 1, l'analyse génère FileNotFoundException et l'initialisation s'arrête avant que tout travail PDF ne soit exécuté.

Cela est corrigé dans IronPDF 2026.8.1. Les versions antérieures sont affectées, y compris 2026.7.0.2, 2025.12.2 et 2025.3.6 sur Windows (win-x64) sous .NET 10.

Solution

L'étape dont vous avez besoin dépend de si vous utilisez le moteur distant IronPdfEngine ou IronPDF natif.

IronPdfEngine distant et IronPdf.Slim

Mettez à niveau vers IronPDF 2026.8.1 ou une version ultérieure. L'analyse au démarrage ne génère plus d'erreurs, donc WEBSITE_RUN_FROM_PACKAGE = 1 peut rester activé et aucun autre changement n'est requis. Le rendu se produit sur le moteur, donc aucun binaire natif n'a besoin d'être extrait dans la racine de l'application en lecture seule.

Consultez Utiliser IronPDF en mode moteur interne pour la configuration de la connexion.

IronPDF natif

La mise à niveau seule ne suffit pas ici. Au démarrage, IronPDF natif extrait les bibliothèques binaires et runtime du moteur Chrome vers un emplacement inscriptible, et un C:\home\site\wwwroot en lecture seule bloque cette extraction indépendamment du bug d'analyse ci-dessus.

Dans vos paramètres d'application Azure, définissez ce qui suit puis redéployez :

WEBSITE_RUN_FROM_PACKAGE = 0
Text

Déploiement depuis Visual Studio ? Décochez Exécuter depuis le fichier de package (recommandé) lors de l'étape de publication.

 Dialogue de publication de Visual Studio avec la case Exécuter depuis le fichier de package (recommandé) décochée

  • En fonction de votre pipeline de déploiement, ce paramètre peut être appliqué depuis plusieurs endroits différents. Identifiez où il est défini et où il pourrait être réécrit.
  • Pour appliquer la modification : vous devez redéployer. Le paramètre seul n'a aucun effet tant que l'application n'est pas redéployée.

Relocalisation des chemins inscriptibles

À partir de 2026.8.1, lorsque le moteur natif ne peut déployer ses binaires Chromium et PDFium sur un système de fichiers en lecture seule, l'erreur de déploiement nomme la cause et les correctifs disponibles au lieu de faire apparaître une défaillance en aval non claire. Un de ces correctifs est de pointer les chemins inscriptibles d'IronPDF vers un endroit en dehors du montage de package :

IronPdf.Installation.TempFolderPath = @"D:\home\data\ironsoftware\";
IronPdf.Installation.CustomDeploymentDirectory = @"D:\home\data\ironsoftware\";

Sur Linux App Service, utilisez /home/data/ironsoftware/ à la place. Définissez ceux-ci avant le premier appel IronPDF. Si le moteur de rendu échoue toujours à se déployer, définissez WEBSITE_RUN_FROM_PACKAGE = 0 comme décrit ci-dessus.

Si vous ne pouvez pas mettre à niveau

Sur les versions avant 2026.8.1, WEBSITE_RUN_FROM_PACKAGE = 0 est la seule solution fiable pour à la fois le moteur natif et le moteur distant, car l'analyse au démarrage s'exécute avant que l'un ou l'autre chemin de code ne soit atteint.

Pour plus de contexte, voir le guide Azure Linux WEBSITE_RUN_FROM_PACKAGE.

Solutions de contournement qui ne fonctionnent pas sur les versions affectées

Toutes ces options ont été testées contre des versions antérieures à 2026.8.1, où l'analyse s'exécute avant tout le reste :

  • Déplacer le premier appel IronPDF hors du démarrage : le plantage se produit toujours lors de la première utilisation depuis un point de terminaison à la demande.
  • Basculer entre WEBSITE_RUN_FROM_ZIP et WEBSITE_RUN_FROM_PACKAGE : les deux montent en lecture seule et échouent de la même manière.
  • Utiliser le IronPdfEngine distant : l'analyse au démarrage s'exécute toujours en premier, donc elle échoue avant même que la connexion distante ne soit utilisée. C'est le comportement spécifique que 2026.8.1 corrige.
  • Définir Installation.TempFolderPath vers un chemin inscriptible : le plantage se produit avant que ce paramètre ne soit lu. À partir de 2026.8.1 le paramètre est lu normalement.

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 22,198,312Version :2026.11tout juste publié