HTTP 502 — Bad Gateway
Que signifie cette erreur ?
Un proxy ou une passerelle a reçu une réponse invalide du serveur applicatif en amont.
Causes probables
- backend arrêté
- mauvais port ou protocole vers le backend
- timeout ou reset réseau
- reverse proxy mal configuré
Vérifications et résolution
- Tester directement le backend depuis le proxy
- Vérifier port, protocole et résolution DNS
- Consulter les logs du reverse proxy et de l’application
- Contrôler les changements récents de certificat ou de configuration
Approfondissement et preuve primaire
HTTP 502 est une réponse générée dans la chaîne HTTP : une passerelle ou un proxy a reçu une réponse invalide de son serveur amont. Le navigateur ou client n’est donc pas nécessairement la cause. Il faut identifier quel composant a émis le statut — application, reverse proxy, load balancer, CDN ou passerelle — et conserver les en-têtes et l’heure de la requête.
Vérification approfondie
Rejouer une requête représentative directement vers l’amont lorsque c’est possible, puis comparer latence, logs applicatifs et logs du proxy. Vérifier la santé des pools, les timeouts configurés, les connexions disponibles et la saturation. Une augmentation de timeout ne corrige pas une application bloquée ; elle peut seulement déplacer le moment où l’échec devient visible.
Critère de validation
La résolution est validée quand le même chemin de requête renvoie une réponse applicative attendue sans HTTP 502, sous une charge représentative et pendant une durée suffisante. Confirmer que le proxy et l’amont partagent des timeouts cohérents et que les métriques ne montrent plus de file d’attente ou d’erreur croissante.
Référence primaire : IETF RFC 9110 — HTTP Semantics.