Guide

Erreur HTTP 502 Bad Gateway : comprendre et agir

Le navigateur atteint parfois le CDN, mais ce dernier ne parvient pas à obtenir une réponse correcte de l’application.

Qu’est-ce qu’une passerelle ?

Un site moderne utilise souvent plusieurs serveurs. Un CDN, proxy inverse, répartiteur de charge ou API Gateway se place devant l’application. Si cet intermédiaire ne reçoit pas de réponse exploitable du serveur d’origine, il peut renvoyer 502 au visiteur. L’incident concerne souvent deux couches serveur, pas directement le navigateur ou la connexion internet.

Que peut faire un visiteur ?

  1. Actualisez une fois et réessayez après un court moment : une interruption passagère entre services est possible.
  2. Ouvrez d’autres sites. S’ils fonctionnent, votre accès internet n’est probablement pas globalement défaillant.
  3. Consultez la page officielle d’état du service, si elle existe.
  4. Un autre réseau ou une fenêtre privée peut aider à diagnostiquer un VPN, proxy ou cache particulier, sans être une solution universelle.

Différences entre 502 et les erreurs proches

502 signifie qu’un intermédiaire a reçu une réponse amont invalide. 503 indique généralement une indisponibilité temporaire, par exemple une surcharge ou une maintenance. 504 signifie qu’une passerelle n’a pas reçu de réponse à temps. Les causes peuvent se recouper, mais ces codes orientent le diagnostic.

Que doit contrôler l’exploitant ?

  1. Origine : l’application et le serveur web tournent-ils sur le port attendu ?
  2. Proxy vers origine : pare-feu et règles réseau autorisent-ils la connexion ?
  3. TLS : nom d’hôte, certificat et protocole correspondent-ils lorsque HTTPS relie les couches ?
  4. Capacité : processus, connexions ou mémoire sont-ils saturés, la réponse trop lente ?
  5. Dernier déploiement : comparez le début de 502 aux changements DNS, certificats et règles de proxy.
  6. Journaux : inspectez à la fois CDN/proxy et serveur d’origine.

Exemple de chaîne de requêtes

Un visiteur ouvre example.com. Le CDN reçoit la requête puis la transmet à l’origine. Si son processus n’écoute plus sur le port 443 ou que TLS échoue, le CDN peut afficher 502 tout en restant lui-même accessible.

Quelle mauvaise première réaction éviter ?

Supprimer tous les cookies, changer de résolveur DNS ou réinstaller le navigateur ne résout généralement pas un 502 entre serveurs. Ces pistes ne sont utiles qu’en présence d’indices d’un proxy local, d’un VPN ou d’un mauvais routage DNS.

Questions fréquentes

502 est-il toujours temporaire ?

Non. Une erreur de configuration peut maintenir l’incident jusqu’à sa correction.

Vider le cache peut-il aider ?

En général non, si le problème se situe entre proxy et origine.

Un CDN peut-il renvoyer 502 ?

Oui, lorsqu’il ne reçoit pas de réponse correcte de son serveur d’origine.

Un certificat peut-il causer 502 ?

Oui, si la connexion TLS entre l’intermédiaire et l’origine ne peut pas aboutir.