502 Bad Gateway in Azure

This article was translated from English: Does it need improvement?
Translated
View the article in English

L'erreur 502 Mauvaise Passerelle est un code d'état HTTP qui indique généralement qu'un serveur de passerelle a reçu une réponse défectueuse d'un autre serveur. En relation avec IronPDF, cette erreur peut se produire lors du déploiement sur Azure.

Dans cet article, vous trouverez plusieurs suggestions pour résoudre cette erreur dans Azure.

1. Décochez "Exécuter à partir du fichier de package"

Lors du déploiement de votre application sur Azure dans Visual Studio, vous verrez une option Exécuter à partir du fichier de package. Assurez-vous que cela est décoché avant de déployer votre application sur Azure. Vous pouvez également définir WEBSITE_RUN_FROM_PACKAGE = 0 dans les paramètres de votre application.

Pour plus d'informations sur l'exécution de votre application à partir d'un fichier de package, consultez la documentation officielle de Microsoft.

2. Changez la région

Parfois, les systèmes de certaines régions Azure effectueront des mises à jour, entraînant des conflits avec IronPDF. Si possible, redéployez votre application dans une autre région.

3. Configurez pour fonctionner en mode de processus unique

Dans votre code, ajoutez la ligne suivante à votre application et redéployez :

// Set IronPDF to run in single process mode
Installation.SingleProcess = true;
// Set IronPDF to run in single process mode
Installation.SingleProcess = true;
' Set IronPDF to run in single process mode
Installation.SingleProcess = True
$vbLabelText   $csharpLabel

Par défaut, IronPDF fonctionne comme un module logiciel multi-processus, démarrant un nouveau processus pour chaque tâche qui lui est donnée (qu'il s'agisse de rendre du HTML, d'envoyer une requête URL, etc.). Cela rend IronPDF tolérant aux pannes mais moins susceptible de fonctionner correctement dans des environnements contraints. En configurant l'option ci-dessus, IronPDF fonctionnera comme un seul processus, ce qui réduira sa tolérance aux pannes mais augmentera la probabilité que la bibliothèque fonctionne correctement dans des environnements contraints.

À cause de ce « compromis », nous recommandons d'essayer d'abord les deux suggestions précédentes avant d'essayer celle-ci.

4. Containerisez votre application

Pour garantir qu'aucun changement dans le système Azure ne perturbe IronPDF, containerisez votre application avec Docker.

Vous pouvez en apprendre davantage sur la manière de containeriser IronPDF avec Docker en suivant ce lien.

Cela ne fonctionne toujours pas ?

Si vous avez essayé toutes les suggestions ci-dessus et que votre application génère toujours l'erreur 502 Mauvaise Passerelle, contactez-nous à support@ironsoftware.com.

To learn how to make a support request, follow this link, and to learn how to retrieve log files from Azure, follow this link.

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

Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir