# Échec du moteur de rendu Chrome au démarrage à froid dans Azure App Service Linux
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 :
```txt
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 :
```csharp
Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();
```
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](/get-started/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.
[[n:( 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.)]]
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
libnss3.so: cannot open shared object file: No such file or directory
Text
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 :
Option Strict On
Option Infer On
Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()
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 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.
