Code erreur HTTP 502 Bad Gateway : passerelle invalide, signification et solutions

À surveiller

Le code HTTP 502 Bad Gateway (« Mauvaise passerelle ») s'affiche dans un navigateur lorsqu'un serveur intermédiaire (passerelle, proxy ou CDN) a reçu une réponse invalide ou incomplète du serveur en amont auquel il tentait d'accéder. En tant que visiteur, l'erreur vient du serveur et non de votre navigateur : patienter quelques instants et recharger la page suffit souvent à la résoudre.

Que signifie le code 502 ?

Selon la documentation officielle MDN Web Docs (référence des standards HTTP définis par l'IETF), le code 502 Bad Gateway indique que le serveur, agissant en tant que passerelle ou serveur mandataire, a reçu une réponse non valide du serveur en amont auquel il tentait d'accéder pour répondre à la requête. Contrairement au code 504 (Gateway Timeout, qui survient lorsqu'aucune réponse n'est reçue dans le délai imparti), le 502 signifie qu'une réponse a bien été reçue mais qu'elle est invalide, incomplète ou incorrectement formatée. L'erreur est générée par la passerelle ou le proxy (load balancer, CDN, reverse proxy Nginx ou Apache), pas par le serveur d'origine lui-même.

Causes probables

  • Serveur en amont (serveur d'application, API, microservice) en panne ou redémarrant au moment de la requête.
  • Réponse du serveur en amont invalide, tronquée ou dans un format que la passerelle ne peut pas interpréter.
  • Délai d'attente (timeout) côté passerelle dépassé avant réception d'une réponse complète du serveur en amont.
  • Problème réseau entre le reverse proxy (Nginx, Apache, CDN) et le serveur d'application en amont.
  • Défaillance d'un microservice dans une chaîne de services, provoquant un effet domino jusqu'à la réponse 502 renvoyée au visiteur.
  • Serveur en amont surchargé, incapable de traiter la requête dans le délai configuré.

Comment résoudre le code 502

  1. Patienter et recharger la page (visiteur). Attendez 1 à 2 minutes et rechargez la page en appuyant sur F5. Une erreur 502 est souvent temporaire : le serveur en amont peut être en cours de redémarrage ou en pic de charge passager.
  2. Vider le cache du navigateur (visiteur). Des données de cache corrompues peuvent parfois afficher une erreur 502 mise en cache. Dans Chrome ou Firefox, appuyez sur Ctrl+Maj+Suppr, sélectionnez le cache et les cookies pour la dernière heure, puis rechargez la page.
  3. Tester depuis un autre réseau ou navigateur (visiteur). Si l'erreur persiste, essayez depuis un autre réseau (connexion mobile 4G/5G) ou un autre navigateur. Si l'erreur disparaît, votre réseau ou votre navigateur peut être impliqué (proxy local, DNS).
  4. Vérifier l'état du serveur en amont (administrateur). Consultez les journaux d'accès et d'erreur du reverse proxy (Nginx, Apache, CDN) pour identifier la source de la réponse invalide. Vérifiez l'état du ou des serveurs d'application en amont (processus actif, mémoire disponible, fichiers de log).
  5. Augmenter les délais de timeout du proxy (administrateur). Si l'erreur 502 survient sur des requêtes longues, augmentez les paramètres de timeout du proxy (proxy_read_timeout sous Nginx, ProxyTimeout sous Apache). Assurez-vous aussi que le serveur en amont peut traiter les requêtes dans ce délai étendu.

Quand faire appel à un professionnel

En tant que visiteur, une erreur 502 persistante signifie que le problème vient du serveur hébergeant le site : contactez le webmaster ou le support du service concerné. En tant qu'administrateur, si l'erreur 502 réapparaît régulièrement, auditez la chaîne de services (reverse proxy, load balancer, serveurs d'application) et envisagez d'augmenter les capacités du serveur en amont ou d'ajuster la configuration du proxy.

Questions fréquentes

Quelle différence entre une erreur HTTP 502 et une erreur 504 ?
Un code 502 Bad Gateway signifie que le serveur mandataire a reçu une réponse invalide ou incorrecte du serveur en amont. Un code 504 Gateway Timeout signifie que le serveur mandataire n'a reçu aucune réponse du serveur en amont dans le délai configuré (timeout). Dans les deux cas, c'est le serveur qui est en cause, mais 502 indique une réponse incorrecte tandis que 504 indique l'absence de réponse.
Un code 502 vient-il toujours du site visité, ou peut-il venir de mon côté ?
Dans la grande majorité des cas, le code 502 est généré par le serveur ou l'infrastructure du site (passerelle, CDN, reverse proxy) et non par votre navigateur ou votre connexion. Vous pouvez vérifier en testant depuis un autre réseau ou un autre appareil : si l'erreur disparaît, un proxy ou un DNS local peut être impliqué.
Combien de temps dure généralement une erreur 502 ?
Une erreur 502 est souvent temporaire : elle disparaît en quelques secondes à quelques minutes si elle est liée à un redémarrage du serveur en amont ou à un pic de charge passager. Si elle dure plus de 10 à 15 minutes sur un site habituellement stable, le serveur en amont peut être en panne prolongée ou un déploiement a introduit une régression.

Autres codes Serveur / HTTP

500Code d'erreur HTTP 500 Internal Server Error : signification et causes 403Code erreur HTTP 403 Forbidden : accès interdit, signification et solutions 503Code erreur HTTP 503 Service Unavailable : serveur indisponible, signification et solutions 400Code erreur HTTP 400 Bad Request : signification et solutions 404Code erreur 404 HTTP : signification, causes et que faire 401Code erreur HTTP 401 Unauthorized : signification et solution 504Code erreur HTTP 504 Gateway Timeout : signification et que faire 501Code erreur HTTP 501 Not Implemented : signification et solution 402Code erreur HTTP 402 Payment Required : signification 407Code HTTP 407 Proxy Authentication Required : signification et solution 408Code erreur HTTP 408 Request Timeout : signification et causes 409Code HTTP 409 Conflict : signification et résolution

Source : MDN Web Docs - 502 Bad Gateway · relevé le 15/06/2026.