HTTP 502 — Bad Gateway
Domaine : HTTPPriorité : Haute
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
Précaution : Ne redémarrez pas tous les services sans conserver les logs de l’incident.
← Revenir à la base des codes d’erreur
Diagnostic HTTP 502 : isoler la panne
- Vérifiez si l’erreur touche tout le site ou uniquement une route et relevez l’heure, l’URL, le nom du proxy et l’ID de requête disponible.
- Depuis le reverse proxy, vérifiez la résolution DNS du serveur d’application et testez directement son port et son protocole (HTTP ou HTTPS).
- Consultez les journaux d’erreurs du proxy et les logs du backend à l’heure exacte : connexion refusée, reset, certificat invalide ou réponse HTTP mal formée.
- Contrôlez les changements récents de configuration, certificat, conteneur, service applicatif ou équilibrage de charge ; corrigez la cause avant tout redémarrage.
- Rejouez la requête et vérifiez que le backend et le proxy donnent une réponse HTTP correcte sans masquer l’erreur derrière un simple changement de timeout.
Quelle différence entre une erreur HTTP 502 et 504 ?
Une erreur 502 signifie que la passerelle a reçu une réponse invalide ou n’a pas pu obtenir une réponse valable de l’amont. Une erreur 504 indique que la réponse attendue du serveur en amont n’est pas arrivée avant le délai d’attente. Les deux erreurs peuvent provenir d’un reverse proxy, mais les pistes de diagnostic diffèrent.
Attention
Conservez les journaux avant les changements. Évitez de rendre publics les endpoints internes, jetons, mots de passe ou fichiers de configuration lors du partage d’une erreur.