Cosa significa
Un gateway o un proxy ha ricevuto una risposta non valida dal server upstream a cui ha inoltrato la richiesta.
Cause comuni
- Il server dell'app è andato in crash o non è in ascolto (porta o socket errati)
- L'upstream ha chiuso la connessione o inviato header malformati
- Riavvio di processi PHP-FPM, Gunicorn o Node
Come risolvere
Lato client o visitatore
Riprova tra un momento; di solito è temporaneo. Se persiste, il backend del sito è fuori servizio.
Lato gestore del sito o dell’API
Verifica che il processo upstream sia attivo e in ascolto sull'indirizzo usato dal proxy, e leggi il log di errore del proxy per l'errore esatto.
Risposta di esempio
HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0Specifica
Domande frequenti
› Come risolvo il 502 Bad Gateway in nginx?
Controlla l'upstream (l'app è in esecuzione, l'indirizzo/socket di proxy_pass è corretto) e il log di errore di nginx; riavvia il server dell'app se è andato in crash.
› 502 o 504?
502: l'upstream ha risposto in modo non valido o ha chiuso la connessione. 504: l'upstream non ha risposto in tempo.