Signification
Une passerelle ou un proxy a reçu une réponse invalide du serveur amont auquel il a transmis la requête.
Causes courantes
- Le serveur d'application a planté ou n'écoute pas (mauvais port ou socket)
- L'amont a fermé la connexion ou envoyé des en-têtes mal formés
- Redémarrage d'un processus PHP-FPM, Gunicorn ou Node
Comment corriger
Côté client ou visiteur
Réessayez dans un instant ; c'est généralement temporaire. Si cela persiste, le backend du site est en panne.
Côté propriétaire du site ou de l’API
Vérifiez que le processus amont tourne et écoute à l'adresse utilisée par le proxy, et lisez le journal d'erreurs du proxy pour connaître l'erreur exacte.
Exemple de réponse
HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0Spécification
FAQ
› Comment corriger 502 Bad Gateway dans nginx ?
Vérifiez l'amont (l'application tourne-t-elle, l'adresse ou le socket proxy_pass est-il correct) et le journal d'erreurs nginx ; redémarrez le serveur d'application s'il a planté.
› 502 ou 504 ?
502 : l'amont a répondu n'importe quoi ou fermé la connexion. 504 : l'amont n'a pas répondu à temps.