HTTP 502 Bad Gateway

Ce que cela signifie

Le code 502 Bad Gateway signifie qu’un serveur faisant office de passerelle ou de proxy (nginx, un CDN comme Cloudflare, un équilibreur de charge) a reçu une réponse invalide, ou aucune réponse, du serveur en amont. La façade fonctionne ; c’est l’application située derrière qui est défaillante.

S'applique à : Tous les navigateurs, nginx, Apache, Cloudflare, AWS ALB

Comment corriger HTTP 502 Bad Gateway

1. Rechargez la page après une minute ; de nombreuses erreurs 502 viennent du redémarrage ou du déploiement d’un serveur d’application
2. Essayez un autre réseau ou un autre appareil pour écarter un proxy défaillant de votre côté
3. Videz le cache et supprimez les cookies du site
4. Si vous êtes propriétaire du site : vérifiez que le service en amont fonctionne ('systemctl status php8.2-fpm', 'pm2 status', 'docker ps')
5. Si vous êtes propriétaire du site : lisez le error.log de nginx à la recherche de 'connect() failed', 'upstream prematurely closed' ou d’erreurs de permissions sur le socket, puis corrigez l’adresse ou le socket en amont
6. Si vous êtes propriétaire du site : recherchez les arrêts forcés par manque de mémoire avec 'dmesg | grep -i kill' et augmentez les limites de processus ou la mémoire si nécessaire
7. Si vous êtes propriétaire d’un site derrière Cloudflare : assurez-vous que le serveur d’origine accepte les plages d’adresses IP de Cloudflare et répond sur le port et le protocole attendus

Pourquoi cela se produit

Le proxy n’a pas pu obtenir de réponse HTTP valide du serveur en amont : le processus d’arrière-plan est arrêté ou a planté, le chemin du socket ou le port est erroné, le serveur ferme prématurément les connexions, ou un pare-feu bloque le trafic entre le proxy et le serveur d’origine.

FAQ

Erreurs liées