Cosa significa
L'utente (o il crawler) parla con un gateway; il gateway parla con l'origine. Un 502 dice che quel secondo hop è fallito: l'origine è andata in crash, è andata in timeout, ha chiuso la connessione o ha restituito qualcosa di malformato. Il gateway in sé di solito sta bene.
Cause comuni
- Processi dell'origine che crashano o terminano a metà richiesta (bug di deploy, errori fatali PHP/Python).
- Timeout dell'origine sotto carico — il gateway molla prima che l'app finisca.
- Esaurimento di risorse: pool di connessioni al database, worker, memoria.
- Configurazione disallineata dopo un deploy: porta, protocollo o nome upstream sbagliato.
Perché interessa la SEO
I crawler che incontrano 502 trattano gli URL come temporaneamente non disponibili e riprovano più tardi — 502 protratti portano alla deindicizzazione esattamente come i 500. Poiché i 502 arrivano spesso a raffiche (picchi di traffico, deploy), monitorare i codici di risposta nel tempo conta più di qualsiasi scansione singola.
Nei log, confronta la frequenza dei 502 con gli orari dei deploy e le curve di traffico — la correlazione di solito nomina il colpevole.
FAQ
Il 502 è un problema del client?
No. Nulla che il browser o il crawler possano cambiare lo risolverà. Il guasto è tra il gateway e il server d'origine.
Come distinguo 502, 503 e 504?
502: l'origine ha restituito una risposta non valida. 503: il server dichiara se stesso non disponibile (spesso con Retry-After). 504: l'origine non ha proprio risposto in tempo.