back to top

Errore 502: cos’è e come risolverlo

In questo articolo spiegheremo cosa significa errore 502 Bad Gateway. Vedremo, attraverso un semplice esempio, cosa succede nel nostro browser quando si verifica l’errore 502 e indicheremo quali sono alcune delle cause dell’errore HTTP 502 e delle possibili soluzioni.

errore 502 di cosa si tratta e come risolverlo

Come si presenta l’Errore 502 Bad Gateway

L’errore 502 viene mostrato, nel browser dell’utente, in differenti forme visto che la pagina di errore puรฒ essere personalizzata. Nel caso piรน comune (quando, cioรจ, non รจ stata predisposta una pagina di errore 502 personalizzata) l’utente visualizzerร  un messaggio del tipo Error 502 – Bad Gateway.

messaggio errore 502 nel browser

E’ anche importante segnalare che questo errore puรฒ presentarsi con diverse diciture, tra cui:

  • Error 502
  • 502 Bad Gateway
  • 502 Proxy Error
  • HTTP Error 502 – Bad Gateway
  • 502 Service Temporarily Overloaded
  • 502 Bad Gateway registered endpoint failed to handle the request
  • 502 Server Error: The server encountered a temporary error and could not complete your request
  • HTTP 502

Puรฒ anche capitare che questo errore si presenti, semplicemente, come una pagina completemante bianca.

Cos’รจ l’Errore 502 e perchรฉ si verifica

Il codice di errore 502 fa parte della categoria dei codici di stato HTTP 5xx (Server Error), ovvero della classe di errori che si riscontrano quando il server non riesce a rispondere correttamente a una richiesta ricevuta.

Ma cosa vuole dire 502 – Bad Gateway? E per quale motivo si verifica questo errore?

Per rispondere a queste domande bisogna prima fare una premessa: nello schema tipco e piรน banale, quando vogliamo visualizzare una risorsa online, il nostro browser invia direttamente una richiesta al server web che ospita tale risorsa. Nel web moderno, tuttavia, questo modello รจ sempre piรน raro: molto spesso, infatti, tra il browser ed il server web che ospita una data risorsa, si frappone un altro server che funge da gateway (in italiano “porta d’accesso”).

L’errore 502 si verifica, appunto, quando il browser dell’utente (client) non ha accesso diretto ai server che ospitano la risorsa (server upstream), ma solo attraverso l’intermediazione di altri server che fungono da proxy, o per essere piรน precisi da reverse proxy, i quali ricevono le richieste dal client e le inoltrano ai server che ospitano le applicazioni web. Questi ultimi inviano quindi una risposta ai server proxy che a loro volta provvedono a recapitarla al client.

client - proxy - server upstream

Un Errore 502 Bad Gateway indica che il server che funge da proxy non รจ stato in grado di ottenere una risposta dal server di origine (server upstream). L’errore 502 si verifica anche nel caso in cui vengono utilizzati i server di una CDN (Content Delivery Network) e questi ultimi non riescono a comunicare con il server remoto che ospita la nostra applicazione web.

Vediamo, di seguito, la schermata tipica dell’errore 502 per i siti web che sfruttano la protezione di CloudFlare.

errore 502 bad gateway cloudflare

Quando si presenta l’errore HTTP 502 (Bad Gateway), il browser visualizza una pagina di errore e l’header del messaggio HTTP ricevuto viene opportunamente settato. Nel caso specifico viene usato il campo Status Code che avrร  come valore 502 Bad Gateway.

esempio errore 502 nel browser

Cause comuni dell’errore 502

Alcune delle possibili cause da cui scaturisce l’errore 502 sono le seguenti:

  • Server upstream non funzionante o non raggiungibile (ad esempio a causa di un down del sistema)
  • Saturazione delle risorse di sistema disponibili (il server non risponde o รจ troppo lento perchรฉ sovraccarico)
  • Errori nel codice di programmazione del sito web
  • Errori nella configurazione dei server
  • Errori di comunicazione fra server upstream e reverse proxy
  • Errata configurazione della CDN

Come risolvere 502 Bad Gateway sul nostro sito

Nel caso in cui si abbia accesso ai server di un sito internet che mostra un Errore 502 Bad Gateway, dovremo cercare di individuare qual รจ il problema che genera un simile errore. A tal proposito i file di log ci danno una grande mano per determinare quali sono le possibili cause dell’errore 502 anche se non รจ sempre facile capire qual’รจ il punto in cui si verifica l’errore.

La prima cosa da fare รจ utilizzare strumenti come ping e traceroute per controllare se i nostri server sono raggiungibili o meno. Un altro utile test รจ utilizzare servizi come down.com coi quali รจ possibile verificare se un dato sito web non รจ raggiungibile per tutti o solo dalla nostra postazione (in quest’ultimo caso, evidentemente, il problema sarร  da cercare localmente).

Nel caso in cui l’errore sia generalizzato รจ opportuno verificare:

  • che il server upstream risponda correttamente, non ci siamo cioรจ errori nel codice che impediscano il caricamento della risorsa oppure dei problemi di saturazione delle risorse di sistema che comportino un eccessiva lentezza nei tempi di risposta;
  • che il server upstream riesca a comunicare con il reverse proxy e che eventuali configurazioni di firewall non impediscano la comunicazione;
  • nel caso si utilizzino CDN, che queste siano configurate correttamente;

Come aggirare l’errore 502 Bad Gateway quando si visita un sito altrui

Come abbiamo visto l’errore 502 รจ causato da problemi che si verificano sui server sui quali l’utente non ha modo di agire direttamente. Se al posto di una pagina che si vuole visitare viene mostrato un messaggio di errore 502, รจ comunque possibile provare ad “aggirare” l’errore 502 Bad Gateway in uno dei modi che descriveremo a breve, essendo comunque consapevoli che potrebbero comunque non funzionare.

In ogni modo, se non dovessimo riuscire a visualizzare il sito a cui siamo interessati, possiamo in alternativa provare ad accedere all’ultima versione salvata nella cache di motori di ricerca come Google e Bing o presente nell’archivio di Wayback Machine cosรฌ come abbiamo illustrato nell’articolo che spiega cos’รจ e come risolvere l’errore 404.

Vediamo quindi alcuni modi per provare ad aggirare l’errore 502 Bad Gateway:

  • รจ possibile eseguire un hard-refresh nel browser che non solo aggiorna la pagina corrente, ma รจ anche un modo per svuotare la cache del browser per quella pagina. Viene cosรฌ caricata la versione piรน recente della pagina stessa. In alternativa si puรฒ comunque svuotare la cache e cancellare i cookie per assicurarsi che il browser non continui a mostrare dei contenuti salvati in cache nel momento in cui un sito web, che si intende visitare, mostrava l’errore 502. A seconda del sistema operativo e del browser, il procedimento da eseguire cambia, ma รจ facile trovare in che modo eseguire un hard-refresh facendo una semplice ricerca su Google.
  • nel caso in cui il problema sia riconducibile a un errore che si verifica durante il processo di risoluzione dei nomi a dominio in indirizzi IP, si puรฒ tentare di cambiare i server DNS o svuotare la cache DNS del proprio dispositivo tenendo presente che, se ci sono state variazioni dei record DNS, รจ necessario attendere che le modifiche vengano propagate completamente (a) seconda del valore del TTL (Time to Live) dei record DNS, puรฒ capitare di dover attendere diverse ore).
  • come ultima alternativa รจ sempre possibile contattare i gestori del sito per segnalare il problema riscontrato.

In questo articolo abbiamo spiegato cos’รจ l’errore 502 Bad Gateway, in quali casi si verifica e quali sono le cause piรน comuni che generano tale errore. Abbiamo quindi visto in che modo risolvere l’errore 502 nel caso in cui si ha accesso ai server che ospitano un sito internet e come provare ad aggirarlo quando visualizziamo l’errore 502 visitando un altro sito internet.

Altri contenuti interessanti

Pubblicitร 

Leggi anche...

ERR_TOO_MANY_REDIRECTS: cos’è e come risolvere l’errore

L'errore ERR_TOO_MANY_REDIRECTS si verifica quando un browser tenta di...

Lucchetto HTTPS barrato di rosso: cosa significa e come risolvere

Il lucchetto HTTPS barrato di rosso mostrato dal browser...

Risolvere l’errore Bad Request … Size of a request header field exceeds server limit

L'errore "Bad Request: Your browser sent a request that...

NGinx: cos’è, come funziona e perché conviene usarlo

Prima di parlare di NGinx, delle sue caratteristiche e...

Errore 410: cos’è, quando si verifica e come risolvere (se necessario)

Il codice di stato HTTP 410 (o “Gone”), più...

Errore 451 Unavailable For Legal Reasons: cos’è e quando si verifica

L'errore HTTP 451 Unavailable For Legal Reasons รจ un...
Pubblicitร