Erreur 502 (Bad Gateway)

Une erreur 502 Bad Gateway signifie qu’un serveur intermédiaire (proxy inverse, CDN ou répartiteur de charge) a reçu une réponse invalide du serveur d’origine en amont auquel il sert de relais.

Ce que cela signifie

L’utilisateur (ou le crawler) parle à une passerelle ; la passerelle parle au serveur d’origine. Une 502 signifie que ce second saut a échoué : l’origine a planté, a dépassé le délai, a fermé la connexion ou renvoyé une réponse mal formée. La passerelle elle-même fonctionne en général correctement.

Causes fréquentes

  • Processus de l’origine qui plantent ou s’arrêtent en plein traitement (bugs après déploiement, erreurs fatales PHP ou Python).
  • Dépassements de délai sous charge : la passerelle abandonne avant que l’application ait fini.
  • Ressources épuisées : pools de connexions à la base de données, workers, mémoire.
  • Configuration incohérente après un déploiement : mauvais port, mauvais protocole ou mauvais nom de serveur amont.

Pourquoi le SEO s’en préoccupe

Les crawlers qui rencontrent des 502 considèrent les URL comme temporairement indisponibles et reviennent plus tard ; des 502 durables conduisent à une désindexation, exactement comme des 500. Comme les 502 surviennent souvent par salves (pics de trafic, déploiements), le suivi des codes de réponse dans le temps compte davantage que n’importe quel crawl isolé.

Comparez la fréquence des 502 à vos déploiements et à vos courbes de trafic dans les logs : la corrélation désigne le plus souvent le coupable.

FAQ

Le 502 est-il un problème côté client ?
Non. Rien de ce que peuvent faire le navigateur ou le crawler ne réglera le problème. La panne se situe entre la passerelle et le serveur d’origine.
Comment distinguer une 502 d’une 503 ou d’une 504 ?
502 : l’origine a renvoyé une réponse invalide. 503 : le serveur se déclare indisponible (souvent avec un en-tête Retry-After). 504 : l’origine n’a pas répondu du tout dans le délai imparti.