Erreurs Bad Gateway : causes et solutions possibles

Mis à jour: 31 août 2026 Temps de lecture: ~

Résumé

Une erreur 502 Bad Gateway se produit lorsqu’un serveur proxy ou une passerelle reçoit une réponse non valide d’un serveur d’origine en amont. Régie par les codes d’état HTTP définis par l’IETF, cette erreur peut provenir de mauvaises configurations DNS, d’une surcharge du serveur ou de problèmes de connectivité avec le pare-feu. Les développeurs et les utilisateurs finaux disposent de mesures concrètes pour diagnostiquer et résoudre ce problème rapidement.

Comprendre l’erreur 502 Bad Gateway

Vous tentez de charger un site web et le message « 502 Bad Gateway » s’affiche à l’écran.

Qu’est-ce que cela signifie ?

Un message « 502 Bad Gateway » indique qu’un serveur a reçu une réponse non valide d’un autre serveur. Fondamentalement, vous vous êtes connecté à un type de terminal intermédiaire (par exemple un serveur périphérique) qui est censé récupérer tout ce dont vous avez besoin pour charger la page. Le processus n’a pas fonctionné comme il le devait et le message signale le problème.

Examinons de plus près ce qui signifie le message « 502 Bad Gateway » et les cinq solutions proposées pour tenter de résoudre le problème.

Que signifie le message « 502 Bad Gateway » ?

Le protocole HTTP (Hypertext Transfer Protocol), soit un ensemble de règles qui régissent le World Wide Web, publiées par l’IETF (Internet Engineering Task Force), est à la base de chaque transaction Internet. Dans le système HTTP, chaque problème est associé à un numéro.

Le code de statut 502, selon l’IETF, signale ce qui suit :

  • Proxy : si vous obtenez un message Bad Gateway, vous utilisez une gateway ou un serveur proxy.

  • Connexion : le proxy a tenté de communiquer avec le serveur d’origine.

  • Erreur : le proxy a obtenu une réponse non valide du serveur.

Le langage numérique peut sembler déroutant, mais il s’avère en réalité très efficace. Un simple chiffre vous en dit long sur la raison pour laquelle la page ne se charge pas.

Comment prévenir et résoudre une erreur 502 bad gateway ?

Personne n’a envie de déchiffrer des codes d’erreur lors de sa navigation web. Et, en tant que développeur, des erreurs de ce type peuvent impacter votre trafic et nuire à votre réputation. La résolution rapide du problème doit être votre priorité.

Causes fréquentes des erreurs 502 :

  • Système de noms de domaine (DNS). Les ordinateurs effectuent une recherche rapide pour convertir une adresse IP numérique en un format standard. Si ce système rencontre un problème (par exemple si vous passez à un nouveau service d’hébergement), un avertissement Bad Gateway s’affiche.

  • Trafic. Il arrive qu’un trop grand nombre de visiteurs surcharge un serveur et l’empêche de résoudre les demandes.

  • Connectivité. Des problèmes de configuration au niveau du pare-feu peuvent bloquer la communication du proxy.

En tant que développeur, vous pouvez résoudre ces problèmes de plusieurs façons :

  • Évaluation. Rencontrez-vous un problème lié au Domain Name System (DNS) ? Ou bien êtes-vous submergé par le trafic ? Vous saurez quel fournisseur contacter ensuite.

  • Test. Utilisez une commande ping ou traceroute pour déterminer si votre serveur est accessible.

  • Équilibrage. Vous pourriez revoir la configuration des pare-feux afin que tout le trafic soit transmis, mais sachez que vous vous exposez ainsi à des risques de sécurité majeurs. Pondérez soigneusement les décisions que vous prenez.

En tant que visiteur, plusieurs possibilités s’offrent à vous :

  • Recharger. Un simple problème de trafic peut disparaître si vous attendez un moment, puis réessayez d’accéder au site.

  • Effacer. Le cache de votre navigateur peut interférer avec la navigation. Videz le cache, puis réessayez.

L’erreur 502 n’est qu’une des erreurs HTTP générées par votre site web, bien d’autres sont possibles. Lisez notre article de blog traitant d’un autre problème courant, l’erreur 431.

Foire aux questions (FAQ)

Qu’est-ce qui provoque une erreur 502 bad gateway ?

Une erreur 502 bad gateway est généralement provoquée par des erreurs de configuration DNS (comme lors du passage à un nouveau service d’hébergement), une surcharge du serveur due à un trop grand nombre de visiteurs ou des problèmes de configuration du pare-feu qui bloquent la communication entre le proxy et le serveur d’origine.

Quelle est la différence entre une gateway et un serveur proxy dans le contexte d’une erreur 502 ?

Dans le contexte d’une erreur 502, les passerelles et les serveurs proxy jouent tous deux le rôle d’intermédiaires entre vous et le serveur d’origine. Selon la définition des codes d’état HTTP de l’IETF, une erreur 502 signifie que la passerelle ou le serveur proxy a reçu une réponse non valide du serveur d’origine en amont qu’il tentait de joindre pour votre compte.

Comment un développeur peut-il diagnostiquer une erreur 502 Bad Gateway ?

Un développeur ou une développeuse peut commencer par évaluer si le problème provient d’un souci de DNS ou d’une surcharge de trafic afin de déterminer quel fournisseur contacter. Ils peuvent ensuite utiliser une commande ping ou traceroute pour vérifier si le serveur est accessible. Si nécessaire, ils peuvent également examiner les paramètres du pare-feu afin de vérifier que le trafic parvient bien au serveur, tout en tenant compte des risques de sécurité.

Que peut faire une personne visitant un site web lorsqu’elle voit une erreur 502 bad gateway ?

Une personne visitant le site peut essayer de recharger la page après une courte attente, car des problèmes de trafic mineurs peuvent se résoudre d’eux-mêmes. Ils peuvent également vider le cache de leur navigateur, ce qui peut parfois nuire à la fluidité de la navigation, puis essayer de charger à nouveau la page.

La modification des paramètres du pare-feu peut-elle résoudre une erreur 502, et quels sont les risques ?

Oui, réduire les paramètres du pare-feu peut contribuer à faire en sorte que l’ensemble du trafic atteigne le serveur et permettre de résoudre une erreur 502 causée par le blocage de la communication avec le proxy. Cependant, cela comporte des risques de sécurité majeurs, il est donc essentiel de bien comprendre les implications avant d’apporter de tels changements.

Quelle norme HTTP régit les erreurs 502 bad gateway ?

Les erreurs 502 bad gateway sont régies par le protocole de transfert hypertexte (HTTP), en particulier par les règles définies par l’Internet Engineering Task Force (IETF). Le code d’état 502 est documenté dans la spécification HTTP/1.1 de l’IETF et indique qu’une passerelle ou un proxy a reçu une réponse non valide d’un serveur en amont.

Références

Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content. Juin 2014. Internet Engineering Task Force.

Continuez votre parcours dans l‘univers de l’identité