Échec du moteur de rendu Chrome au démarrage à froid dans Azure App Service Linux

Mis à jour:9 juin 2026

Translated

View the article in English

Ce problème survient sur Azure App Service Linux lorsque l'image de base Oryx/Ubuntu sous-jacente est mise à jour par Azure, supprimant les bibliothèques partagées dont dépend le moteur de rendu Chrome d'IronPDF. Lors du prochain démarrage à froid, IronPDF doit réinstaller ces dépendances Chrome natives à partir de zéro, un processus qui peut prendre jusqu'à 5 minutes. Si le délai d'attente du démarrage de l'application est trop court, l'installation est interrompue et le moteur de rendu échoue.

L'erreur apparaît généralement comme suit :

libnss3.so: cannot open shared object file: No such file or directory

Azure met périodiquement à jour l'image de base utilisée par les environnements App Service Linux. Ces mises à jour peuvent supprimer des bibliothèques partagées telles que libnss3.so nécessaires à Chrome. Quand cela se produit, le mécanisme LinuxAndDockerDependenciesAutoConfig d'IronPDF tente de réinstaller les packages requis au démarrage. Si le délai d'attente du service est plus court que le temps nécessaire pour finaliser cette installation, le processus est interrompu avant que Chrome ne soit prêt.

Ce problème a été confirmé dans l'environnement suivant :

Version affectée : IronPDF 2026.4.1
Version non affectée : IronPDF 2026.5.2
Hébergement : Plan Azure App Service P0v3, région Norvège Est
Environnement d'exécution : .NET 10

Solution

Solution 1 : Appliquez les paramètres d'initialisation et augmentez le délai d'attente du démarrage

Ajoutez le code d'initialisation suivant au démarrage de l'application, avant tout appel de rendu 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

Définir LinuxAndDockerDependenciesAutoConfig sur true ordonne à IronPDF de détecter et d'installer automatiquement les dépendances Linux manquantes. Définir ChromeGpuMode sur IronPdf.Engines.Chrome.ChromeGpuModes.Disabled désactive l'accélération GPU, qui n'est pas disponible dans les environnements Azure App Service Linux. Activer la journalisation complète permet de capturer les erreurs eventuelles lors de l'étape d'installation des dépendances.

Ensuite, augmentez le délai d'attente du démarrage de l'Azure App Service à au moins 10 minutes. Cela donne à IronPDF suffisamment de temps pour terminer la réinstallation des dépendances lors d'un démarrage à froid après une mise à jour de l'image de base Azure. Consultez le guide de déploiement Azure pour obtenir des instructions sur la façon d'ajuster le réglage du délai de démarrage dans la configuration App Service.

Solution 2 : Mettez à niveau vers IronPDF 2026.5.2 ou ultérieur

La mise à niveau vers IronPDF 2026.5.2 ou une version ultérieure résout ce problème. La version non affectée gère le cas où les mises à jour de l'image de base Azure suppriment des bibliothèques partagées sans provoquer de panne au démarrage à froid.

Important Ce problème a été résolu dans IronPDF 2026.5.2. Si vous utilisez cette version ou une version ultérieure, les solutions de contournement mentionnées dans la Solution 1 ne sont plus nécessaires.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

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 ...

Prêt à commencer ?

Nuget Téléchargements 20,088,359 | Version : 2026.7 vient de sortir