Guida

Errore 502 Bad Gateway: cosa fare

Un gateway o proxy non ha ricevuto una risposta valida dal server a monte. La causa spesso è temporanea.

Che cos'è un gateway?

Un gateway o reverse proxy riceve la richiesta dal browser e la inoltra al server di origine. HTTP 502 Bad Gateway significa che il gateway non ha ottenuto una risposta valida dal sistema a monte; non dice automaticamente quale componente sia guasto.

Cosa può fare un visitatore?

Ricarica una volta dopo un breve intervallo, controlla se il problema riguarda anche altre pagine e prova da un'altra rete. Non modificare subito DNS o certificati del dispositivo: spesso la causa risiede fra proxy e server.

502 e altri errori simili

502 indica una risposta non valida dal server a monte. 503 segnala indisponibilità temporanea del servizio, mentre 504 indica un timeout nel rapporto fra gateway e origine. Un 522 di Cloudflare riguarda invece l'instaurazione della connessione all'origine.

Controlli per chi gestisce il sito

Confronta i log del proxy e dell'origine. Controlla errori applicativi, connessioni terminate prematuramente, limiti di processo, TLS verso il backend e salute dei pool. Correggi la causa, non limitarti ad aumentare i timeout.

Una tipica catena della richiesta

Il percorso può essere browser, CDN, load balancer, reverse proxy e applicazione. Un errore lungo la catena può emergere come 502 anche se il server pubblico risponde normalmente al TCP. Usa identificativi e orari per collegare i log.

Cosa non conviene fare per prima cosa?

Non disattivare il firewall, reinstallare il browser o svuotare tutte le impostazioni di rete senza indizi. Un 502 riproducibile da più reti richiede in genere un'indagine lato servizio e un ripristino del backend.

Domande frequenti

Un errore 502 dipende dal mio computer?

Di solito no: segnala una comunicazione anomala fra server intermedi e origine, anche se una rete particolare può talvolta influire.

502 e 504 sono la stessa cosa?

No. Un 502 riguarda una risposta a monte non valida; un 504 riguarda il mancato arrivo della risposta entro il tempo limite.

Ricaricare la pagina può aiutare?

Sì, se il guasto è transitorio. Non inviare ripetutamente ordini o pagamenti senza verificare prima l'esito dell'operazione.

Che cosa deve verificare il proprietario?

I log correlati di CDN, proxy e applicazione, lo stato del backend e le connessioni TLS o TCP a monte.

Fonti