Panne / symptôme

Un site répond 502 Bad Gateway

Le proxy ou serveur frontal n’obtient pas une réponse valide du serveur applicatif amont.

⌚ Environ 4 min de lecture
Voir mes favoris
Problème réel · V2

Vue diagnostic rapide

Ce que vous observez

Le proxy ou serveur frontal n’obtient pas une réponse valide du serveur applicatif amont.

Causes probables
  1. Backend arrêté
  2. PHP-FPM indisponible
  3. Timeout
Premiers contrôles
  1. Identifier le frontal
  2. Tester le backend directement
  3. Lire les logs proxy et application
Actions recommandées
  1. Rétablir le backend
  2. Corriger l’adresse/port du proxy
  3. Adapter les timeouts seulement après avoir compris la cause
Lancer Symptôme → Cause →
+
Afficher le guide détaillé completExplications détaillées et contenu de dépannage original.
WebIntermédiaire

Le proxy ou serveur frontal n’obtient pas une réponse valide du serveur applicatif amont.

Important : relevez toujours le message d’erreur exact et l’heure du problème avant de modifier la configuration. Les actions proposées doivent être adaptées à votre environnement.

Causes probables

  • Backend arrêté
  • PHP-FPM indisponible
  • Timeout
  • Reverse proxy mal configuré
  • Application saturée

Diagnostic étape par étape

  1. 1

    Identifier le frontal

    Déterminez si Nginx, Apache, CDN ou proxy renvoie le 502.

  2. 2

    Tester le backend directement

    Si possible, vérifiez le service amont.

  3. 3

    Lire les logs proxy et application

    Cherchez timeout, connection refused ou reset.

  4. 4

    Vérifier les ressources

    CPU, RAM, workers et connexions peuvent être saturés.

Solutions possibles

  • Rétablir le backend
  • Corriger l’adresse/port du proxy
  • Adapter les timeouts seulement après avoir compris la cause
Quand escalader ?

Escaladez à l’hébergeur si le backend ou les ressources serveur sont hors de votre contrôle.

Validation du diagnostic

Pour « Un site répond 502 Bad Gateway », consignez l’URL exacte, la méthode HTTP, l’heure, le code reçu et les en-têtes utiles avant toute modification. Distinguez la réponse du client, du reverse proxy et de l’application afin d’éviter d’attribuer au serveur d’origine une erreur produite par un intermédiaire.

Test discriminant

Rejouez la requête de façon contrôlée depuis un client connu, puis comparez le résultat en accès direct à l’origine et via le chemin normal. Conservez le statut, les en-têtes et le journal serveur correspondant au même horodatage ; ce croisement permet de localiser la couche qui génère réellement l’échec.

Critère de résolution

Considérez l’incident résolu seulement lorsque la requête représentative retourne le statut attendu plusieurs fois de suite et que les journaux ne montrent plus la cause initiale. Si le correctif modifie cache, proxy, authentification ou routage, vérifiez aussi une requête non mise en cache et un second client.

Concepts liés

Référence primaire : RFC 9110 — HTTP Semantics.

♡ 0