Guide diagnostic 502 - Bad Gateway
Comprendre 502, reconnaitre les symptomes, verifier les causes probables et appliquer les solutions sans perdre de temps.
Resume rapide
Le proxy ou serveur frontal ne recoit pas de reponse valide depuis l'application.
Le code 502 appartient a la categorie HTTP serveur. Il faut confirmer le symptome, verifier les causes simples, puis appliquer une correction progressive avant toute action lourde.
Symptomes a reconnaitre
- Site inaccessible
- Erreur intermittente
- Application backend arretee
Causes probables
- Service backend coupe
- Timeout
- Mauvais port proxy
- Ressources serveur insuffisantes
Plan d'action
- Verifier que l'application tourne
- Controler les logs Nginx ou Apache
- Verifier le port et l'adresse du proxy
- Redemarrer proprement le service apres correction
Methode de diagnostic
Pour un site web ou un serveur, le code peut venir du serveur d'origine, du DNS, du certificat SSL, du cache, du proxy ou d'une limite de ressources. Les logs sont souvent la meilleure source pour trouver la cause.
- Testez l'URL depuis un autre navigateur ou reseau pour isoler un probleme local.
- Verifiez les logs serveur, PHP, proxy, CDN ou hebergement.
- Controlez DNS, certificat SSL, cache et disponibilite de la base de donnees.
Pour une gravite haute, evitez les actions irreversibles avant sauvegarde, verification des branchements, lecture des logs ou controle du contexte exact.
Erreurs a eviter
- Effacer le code avant d'avoir note le message exact et le contexte.
- Remplacer une piece ou reinstaller un systeme sans preuve de la cause.
- Ignorer les signes de gravite comme chauffe, fuite, STOP machine, perte de donnees ou voyant rouge.
- Faire plusieurs essais au hasard sans verifier si le symptome change.
Quand demander de l'aide ?
Demandez de l'aide si les logs montrent des erreurs serveur repetees ou une indisponibilite de la base de donnees.
Non. Consultez d'abord les logs, le DNS, le certificat SSL, le cache et l'etat de l'hebergement. Une modification sans diagnostic peut aggraver la panne.
Continuer le diagnostic
La fiche detaillee contient les symptomes, causes, solutions et questions frequentes specifiques au code.