Come risolvere l’errore 502 bad gateway

Un errore 502 bad gateway è un comune codice di stato HTTP che puoi facilmente risolvere con la risoluzione dei problemi.

In questa guida, delineeremo dieci passaggi pratici per diagnosticare e risolvere un errore 502 bad gateway sia per problemi lato client che lato server. Esploreremo varie possibili cause, assicurandoci che tu abbia una comprensione completa di ciò che potrebbe non andare bene.

Codice di errore	Errore 502 bad gateway
Tipo di errore	Errore lato server
Variazioni di errore	Errore temporaneo (502) Errore HTTP 502 bad gateway Errore 502 Proxy Bad 502 gateway 502 servizio temporaneamente sovraccarico Uno schermo bianco vuoto
Cause degli errori	Problemi del server upstream Il server proxy ha ricevuto una risposta non valida Errori di comunicazione di rete tra i server Sovraccarico del server a causa dell’alto traffico Cache del browser difettoso o estensioni Impostazioni DNS errate Firewall configurato in modo errato o problemi con la CDN

Cosa causa un errore 502 bad gateway

Un messaggio di errore 502 Bad Gateway deriva da un fallimento nella comunicazione tra i server web. Si verifica quando un server che funge da intermediario riceve una risposta da un altro server che non riesce a capire o elaborare. Principalmente, ci sono quattro cause del 502 bad gateway:

• Risposta senza senso: l’altro server web ha inviato dati errati o incompleti.
• Formato errato: la risposta è nel linguaggio o formato tecnico sbagliato per l’interpretazione del server intermediario.
• Sovraccarico del server: l’altro server è troppo occupato e non riesce a rispondere correttamente.
• Problemi di rete: malfunzionamenti nella connessione tra i server.

Questi problemi impediscono al server intermediario di soddisfare la tua richiesta, provocando un errore 502.

Variazioni dell’errore 502 bad gateway

Un errore 502 può apparire su qualsiasi dispositivo o servizio, ma il messaggio esatto potrebbe differire. Ecco alcune variazioni di questo codice di stato HTTP che potresti vedere:

• Semplice: Errore temporaneo (502), Errore 502.
• Descrittivo: Errore HTTP 502 Bad Gateway, Errore del server 502, con una spiegazione.
• Tecnico: 502 – Il server web ha ricevuto una risposta non valida, HTTP 502, Errore Proxy 502.
• Sovraccarico: 502 servizio temporaneamente sovraccaricato.
• Specifico per il server: 502 Bad Gateway Nginx, a seconda del software del server.
• Schermo bianco: alcuni siti web mostrano uno schermo bianco semplice.

Alcuni proprietari di siti web creano pagine di errore uniche con informazioni aggiuntive. Ad esempio, Chrome offre consigli per la risoluzione dei problemi e suggerisce di riprovare.

GitLab spiega il problema di comunicazione e fornisce soluzioni.

X (precedentemente Twitter), d’altra parte, mostra un messaggio amichevole con un’illustrazione.

Come risolvere l’errore 502 bad gateway

Nella maggior parte dei casi, l’errore 502 Bad Gateway è temporaneo: devi solo aspettare circa 30 secondi perché scompaia. Per una ulteriore risoluzione dei problemi, prova quanto segue:

1. Aggiorna la pagina

Di solito, un errore 502 bad gateway è temporaneo, derivante da un improvviso aumento del traffico. Un rapido aggiornamento può risolvere il problema.

Su Windows, premi F5 o CTRL + F5. Su Mac, usa CMD + R.

2. Controlla lo stato del sito

Se il codice di errore 502 continua a comparire, è possibile che il server del sito web sia attualmente inattivo.

Fortunatamente, ci sono molti strumenti per verificare se il sito è inattivo, incluso Down for Everyone or Just Me e IsItDown. Inserisci semplicemente il tuo URL e controlla lo stato del sito web.

3. Svuota la cache del tuo browser

Se l’errore di risposta non valida persiste, c’è la possibilità che la cache del tuo browser abbia salvato file obsoleti e danneggiati. In questo caso, svuotare la cache del browser può offrire una soluzione al problema 502 Bad Gateway.

Ricorda che la rimozione dei file memorizzati nella cache potrebbe comportare la perdita di importanti dati del browser, inclusi segnalibri e preferenze di impostazione. Per prevenire ciò, esporta semplicemente i tuoi dati dal browser e importali di nuovo dopo.

4. Prova in modalità incognito

Accedi al sito web in modalità Incognito per determinare se l’errore 502 gateway timeout appare a causa di un problema relativo al browser. Per aprire una finestra in incognito, clicca sul pulsante con tre puntini sullo schermo del tuo browser e scegli Nuova finestra in incognito.

Se l’errore non si verifica in modalità incognito, è probabile che la causa sia la tua estensione del browser.

Prova a disabilitare i tuoi Add-ons o estensioni uno alla volta. Quando elimini l’estensione che causa l’errore, dovresti essere in grado di accedere al sito web. Dalla nostra esperienza, di solito l’estensione ad-blocker è la colpevole.

Se disabilitare le estensioni del browser non aiuta, prova un browser diverso. Ad esempio, se stai attualmente utilizzando Google Chrome, prova a usare Mozilla Firefox.

Se la pagina funziona sul nuovo browser, potrebbe essere il tuo browser precedente a causare l’errore. Per risolvere il problema, prova a eliminare e reinstallare il tuo browser difettoso.

5. Svuota la cache DNS

Altre cause comuni del 502 bad gateway sono problemi DNS, come indirizzi IP errati e server DNS non reattivi.

In questo caso, svuotare la tua cache DNS può essere la risposta. Questo metodo funziona in modo simile alla pulizia della cache del tuo browser. Rimuoverà i file difettosi dal tuo server DNS.

Considera anche di cambiare temporaneamente i tuoi server DNS. Per impostazione predefinita, il tuo ISP assegna i tuoi server DNS. Tuttavia, puoi sempre cambiarlo con un server di terze parti, come Google Public DNS.

6. Prova su un altro dispositivo

Se nessuna delle correzioni dell’errore 502 sopra indicato funziona, prova la tua connessione internet su un altro computer o un dispositivo mobile, idealmente connesso a una rete diversa.

Inoltre, prova a riavviare il tuo computer e il tuo router. Fare ciò mostra se l’errore è legato al tuo equipaggiamento di rete o se il problema si trova altrove.

7. Controlla i log degli errori

Se incontri un errore 502 del sito web dopo una modifica o un aggiornamento, potresti avere a che fare con un errore del server web. Il miglior approccio per risolvere questo problema è controllare il log dell’errore del tuo sito web.

Di solito, il tuo servizio di hosting ti consente di accedere ai file di log degli errori del tuo sito web tramite una dashboard di amministrazione. Puoi anche abilitare i log degli errori sul tuo sito web WordPress aggiungendo le seguenti righe su wp-config.php:

define( 'WP_DEBUG', true );

define( 'WP_DEBUG_LOG', true );

define( 'WP_DEBUG_DISPLAY', false );

Tutti gli errori generati appariranno nel file wp-contents/debug.log, permettendoti di rilevare quali stanno causando un errore 502 bad gateway.

8. Controlla i plugin e i temi

A volte, plugin difettosi o temi possono causare l’errore.

Questo perché i plugin e i temi codificati in modo scadente possono entrare in conflitto tra loro. Quando questo accade, il tuo server interromperà ogni script e query sul tuo sito web, rendendolo inaccessibile.

Per alcuni siti web, il problema di solito deriva da plugin di caching o di sicurezza. C’è una buona possibilità che questi plugin blocchino la comunicazione tra i server, causando la persistenza dell’errore.

Se non hai un plugin di caching o di sicurezza installato ma incontri ancora l’errore HTTP 502, è meglio disabilitare i tuoi plugin e riattivarli uno per uno. Per farlo, vai su Plugin e semplicemente clicca su Disattiva dal menu Azioni collettive.

Quindi, attiva ogni plugin mentre aggiorni il tuo sito WordPress dopo ciascuno di essi. Una volta che riappare l’errore 502, hai trovato il plugin problematico.

Tuttavia, se non puoi accedere alla tua dashboard di WordPress, puoi provare a disabilitarli dal tuo pannello di hosting o dal programma FTP. Naviga nella directory wp-content e rinomina la directory dei plugin, ad esempio, plugin-disabilitati.

Se usi Hostinger, accedi al tuo hPanel e clicca su File. Da lì, vai al File manager → public_html → wp_content.

Una volta che il tuo sito inizia a funzionare dopo aver disabilitato tutti i plugin, potresti rinominare la cartella di nuovo in plugin. Quindi, prova ad abilitare i plugin uno alla volta per determinare quale ha causato l’errore in primo luogo.

Se il sito web non funziona ancora, segui gli stessi passaggi con i tuoi temi WordPress.

9. Controlla la tua rete di distribuzione dei contenuti (CDN)

Un’altra causa degli errori 502 Bad Gateway possono essere problemi con la tua rete di distribuzione di contenuti (CDN) o servizi di mitigazione DDoS.

Una CDN aggiunge un ulteriore livello tra il tuo server e il browser per consegnare i contenuti web in modo efficiente. Tuttavia, questo livello può incontrare un problema quando si connette con il tuo server di origine, risultando in errori 502.

Un esempio notevole è Cloudflare, dove l’errore 502 Bad Gateway può verificarsi in due diverse varianti a seconda del problema.

Lo screen sopra indica che il problema è da parte di Cloudflare. Per risolverlo, dovrai contattare il loro team di assistenza clienti. Ricorda di controllare la pagina dello stato del sistema di Cloudflare prima di farlo.

In alternativa, puoi disattivare Cloudflare. Tuttavia, tieni presente che la propagazione del tuo DNS potrebbe richiedere un paio di ore.

Se vedi l’errore di Cloudflare mostrato sopra, significa che il problema risiede nel tuo attuale fornitore di web hosting. In questo caso, prova a contattare il team di supporto del tuo web hosting e chiedi assistenza.

10. Aumenta max_execution_time e max_input_time di PHP

Il timeout di PHP si verifica ogni volta che un processo PHP si carica per più tempo del max_execution_time o max_input_time specificato. Questi sono i valori impostati nelle tue configurazioni PHP sul tuo server web. Di solito, i valori sono impostati a 300 secondi per impostazione predefinita.

Durante il processo di migrazione può verificarsi un timeout e generare un errore 502 Bad Gateway. Per risolvere questo problema, puoi contattare il servizio clienti del tuo fornitore di hosting per controllare a che livello sono impostati i tuoi valori e se puoi aumentarli.

Conclusioni

Incontrare un errore 502 bad gateway può essere fastidioso, ma è un problema comune che deriva da un errore di comunicazione tra i server.

Ci sono molte ragioni per questo errore, tra cui la cattiva configurazione del server, sovraccarichi, bug del software e problemi di rete.

Per risolvere un errore di rete 502, aggiorna la pagina, controlla le configurazioni del server, assicurati che la rete sia stabile, svuota la cache DNS o controlla se c’è un downtime generale.

FAQ sull’errore 502 bad gateway