Un 502 Bad Gateway significa che un server che funziona come gateway o proxy ha ricevuto una risposta non valida dal server a monte, chiamato upstream server.
In italiano, Bad Gateway può essere tradotto letteralmente come gateway non valido. Nella pratica indica un problema nella comunicazione tra due componenti dell’infrastruttura che devono collaborare per restituire una pagina o una risorsa.
Se visualizzi l’errore mentre stai semplicemente visitando un sito, nella maggior parte dei casi il problema non dipende dal tuo computer. Se invece il sito è tuo, occorre capire quale elemento della catena — proxy, web server, PHP, CDN o applicazione — non sta funzionando correttamente.
Vediamo quindi cosa significa l’errore 502, perché compare e come diagnosticarlo, con un approfondimento specifico per WordPress, Nginx e Cloudflare.
502 Bad Gateway: significato e traduzione in italiano
Il codice HTTP 502 Bad Gateway appartiene alla famiglia degli errori 5xx, cioè i codici che segnalano un problema verificatosi lato server.
Una situazione semplificata può essere rappresentata così:
Browser → gateway o proxy → server upstream
Il browser invia una richiesta. Un server intermedio, ad esempio un reverse proxy, una CDN o Nginx, inoltra quella richiesta a un altro servizio.
Se il gateway riceve dall’upstream una risposta che non può utilizzare correttamente per completare la richiesta, può restituire al browser un 502 Bad Gateway.
Il messaggio può apparire con diciture differenti, tra cui:
- 502 Bad Gateway
- HTTP 502
- HTTP Error 502
- 502 Error
- 502 Proxy Error
- 502 Bad Gateway Nginx
- Bad Gateway
La forma può cambiare, ma il significato di fondo rimane lo stesso.
Cosa significa esattamente il codice HTTP 502
La definizione è importante perché il 502 viene spesso confuso con un generico problema di lentezza del server.
Il 502 Bad Gateway indica invece un problema nella risposta ricevuta dal gateway o proxy dal servizio a monte necessario per elaborare la richiesta.
Nelle infrastrutture reali può comparire, ad esempio, quando:
- il servizio upstream non è raggiungibile;
- una connessione viene rifiutata o interrotta;
- il backend termina in modo anomalo;
- il proxy non riesce a comunicare correttamente con PHP o con un altro servizio;
- la risposta ricevuta dall’upstream non è utilizzabile.
Non bisogna però confondere il 502 con il 504 Gateway Timeout.
Nel significato previsto dal protocollo HTTP, il 504 indica che il gateway non ha ricevuto una risposta dal server upstream entro il tempo necessario.
Differenza tra errore 500, 502, 503 e 504
| Codice | Significato |
|---|---|
| 500 Internal Server Error | Il server ha incontrato una condizione imprevista che gli impedisce di completare la richiesta |
| 502 Bad Gateway | Il gateway o proxy ha ricevuto una risposta non valida dall’upstream |
| 503 Service Unavailable | Il servizio non è temporaneamente disponibile, ad esempio per sovraccarico o manutenzione |
| 504 Gateway Timeout | Il gateway o proxy non ha ricevuto dall’upstream una risposta entro il tempo previsto |
Questa distinzione è fondamentale per evitare interventi sbagliati.
Se il problema è un 502 non ha senso aumentare automaticamente i timeout come prima soluzione. Bisogna prima identificare quale servizio sta interrompendo o rendendo inutilizzabile la comunicazione.
Per comprendere meglio anche gli altri codici puoi consultare la nostra guida ai codici di stato HTTP, l’approfondimento sull’errore 500 Internal Server Error e quello dedicato al 504 Gateway Timeout.
Perché compare un errore 502 Bad Gateway
Il codice 502 descrive il risultato del problema, non necessariamente la sua causa.
Per questo non esiste una singola soluzione valida in ogni situazione.
Le cause più frequenti riguardano la comunicazione tra proxy e backend, il runtime PHP, l’applicazione, la CDN o altri servizi che partecipano alla generazione della risposta.
Server upstream non raggiungibile o risposta non valida
È uno degli scenari più comuni.
Il gateway prova a comunicare con un servizio a monte, ma quest’ultimo:
- non è in esecuzione;
- rifiuta la connessione;
- interrompe la connessione prima di completare la risposta;
- non è raggiungibile sulla porta o sul socket configurato;
- restituisce una risposta che il proxy non può utilizzare;
- termina a causa di un errore o della mancanza di risorse.
Il browser non vede necessariamente il componente che ha causato il problema.
Riceve soltanto il risultato finale: 502 Bad Gateway.
Problemi tra Nginx, reverse proxy e PHP
Nginx viene frequentemente utilizzato come web server o reverse proxy davanti a PHP e ad altri servizi applicativi.
In questo scenario un errore 502 può comparire quando:
- il runtime PHP non è disponibile;
- PHP-FPM o un servizio FastCGI è stato arrestato;
- il socket configurato non esiste o non è accessibile;
- la porta dell’upstream è errata;
- il backend chiude prematuramente la connessione;
- un processo PHP termina durante l’elaborazione;
- proxy e backend non riescono a comunicare correttamente.
In questi casi il punto di partenza non dovrebbe essere WordPress ma il log degli errori del web server.
Se utilizzi questo stack, puoi approfondire anche la nostra guida su Nginx e l’analisi dei suoi log.
CDN, Cloudflare, proxy e firewall
Se davanti al sito utilizzi una CDN o un reverse proxy come Cloudflare, viene aggiunto un ulteriore livello alla catena delle richieste.
Il percorso può diventare, ad esempio:
Browser → Cloudflare → server origin → PHP → WordPress
Un 502 può quindi essere generato dall’origin oppure comparire perché il proxy non riesce a comunicare correttamente con l’origin.
In presenza di Cloudflare verifica soprattutto:
- che il server origin sia raggiungibile;
- che il servizio web sia attivo;
- che il firewall non blocchi le connessioni necessarie;
- che DNS e indirizzo dell’origin siano corretti;
- che le porte utilizzate siano disponibili;
- che la configurazione SSL/TLS sia coerente;
- i log del server nell’orario esatto in cui compare l’errore.
Disattivare CDN, firewall e proxy senza una diagnosi non dovrebbe essere il primo intervento. È preferibile capire da quale livello della catena proviene il 502.
Per distinguere gli errori generati dall’origin da quelli legati all’infrastruttura proxy puoi fare riferimento anche alla documentazione Cloudflare sugli errori 502 e 504.
Sovraccarico, risorse e problemi applicativi
Un’applicazione può provocare indirettamente un errore 502 se porta il servizio che la esegue a terminare o a interrompere la connessione.
Tra le situazioni da controllare ci sono:
- processi PHP terminati;
- memoria esaurita;
- worker disponibili esauriti;
- crash del runtime;
- errori applicativi gravi;
- servizi esterni non raggiungibili;
- container o backend arrestati;
- picchi improvvisi di richieste.
Un database lento o una richiesta che richiede troppo tempo possono invece condurre, a seconda dell’infrastruttura e del punto in cui si verifica il problema, anche ad altri errori della famiglia 5xx.
Per questo è meglio non dedurre la causa dal solo numero 502: servono i log.
Cosa fare se visualizzi un 502 come visitatore
Se stai visitando un sito e compare un 502 Bad Gateway, le possibilità di intervento sono limitate perché il problema è normalmente legato al server o all’infrastruttura che sta elaborando la richiesta.
Puoi comunque effettuare alcuni controlli rapidi.
Per prima cosa, attendi qualche minuto e ricarica la pagina. Un servizio upstream potrebbe essere stato temporaneamente riavviato oppure il problema potrebbe essere già in fase di risoluzione.
Puoi poi provare:
- un’altra connessione;
- un altro dispositivo;
- la navigazione senza VPN o proxy;
- una rete mobile al posto del Wi-Fi.
Se il sito restituisce lo stesso errore da dispositivi e connessioni differenti, il problema è quasi certamente lato servizio.
Svuotare cache e cookie del browser può essere utile per escludere anomalie locali, ma non è una vera soluzione a un 502 generato dall’infrastruttura server.
Lo stesso vale per il cambio dei DNS locali: può essere un test diagnostico in casi particolari, ma non deve essere considerato una delle cause principali del codice HTTP 502.
Come risolvere il 502 se il sito è tuo
Se amministri il sito, evita di modificare contemporaneamente plugin, DNS, CDN, PHP e server.
La diagnosi deve seguire una sequenza.
1. Verifica l’estensione del problema
Controlla se il 502 interessa:
- tutto il sito;
- una singola pagina;
- il frontend ma non il backend;
- soltanto richieste dinamiche;
- API o endpoint specifici;
- determinate operazioni, come login, checkout o salvataggi.
Annota inoltre l’orario esatto dell’errore.
È un’informazione molto utile perché permette di confrontare il problema con gli eventi registrati nei log.
2. Controlla prima i log
I log sono la fonte principale per capire che cosa è successo.
Controlla, in base alla tua infrastruttura:
- error log del web server;
- log PHP;
- log PHP-FPM o FastCGI;
- log del reverse proxy;
- log applicativi;
- eventi della CDN;
- log dei container, se presenti.
Cerca soprattutto gli eventi immediatamente precedenti al 502.
Messaggi relativi a connessioni rifiutate, socket mancanti, processi terminati, memoria esaurita o backend non raggiungibili possono indicare rapidamente il componente responsabile.
3. Verifica che i servizi siano attivi
Se hai accesso all’infrastruttura, controlla lo stato dei servizi coinvolti.
A seconda dello stack possono essere:
- Nginx;
- Apache;
- PHP-FPM;
- PHP FastCGI;
- database;
- reverse proxy;
- container;
- servizi applicativi.
Un semplice riavvio può riportare il sito online, ma non dovrebbe concludere la diagnosi.
Se un servizio si è arrestato, la domanda successiva è:
perché si è arrestato?
Senza questa verifica il 502 potrebbe ripresentarsi.
4. Controlla le modifiche recenti
Se l’errore è iniziato subito dopo una modifica, parti da quella.
Ad esempio:
- aggiornamento di WordPress;
- aggiornamento di un plugin;
- cambio tema;
- cambio versione PHP;
- modifica della configurazione Nginx o Apache;
- modifica di DNS o proxy;
- introduzione di una CDN;
- modifica delle regole firewall;
- migrazione del sito.
Ripristinare o verificare una singola modifica recente è molto più efficace che intervenire casualmente su tutta l’infrastruttura.
Errore 502 Bad Gateway su WordPress
Un errore 502 Bad Gateway su WordPress non significa necessariamente che WordPress sia la causa.
Questa distinzione è particolarmente importante.
Se il proxy non riesce a comunicare con il runtime PHP, infatti, WordPress potrebbe non essere stato nemmeno eseguito.
Per questo il primo controllo deve riguardare web server, PHP e relativi log.
Solo dopo ha senso passare ai componenti WordPress.
Controlla plugin e temi
Se il problema è iniziato subito dopo l’installazione o l’aggiornamento di un plugin, disattiva innanzitutto quel componente.
Se non puoi entrare nella dashboard di WordPress, puoi utilizzare File Manager, SSH o FTP per rinominare temporaneamente la directory del plugin sospetto.
Se non hai indizi su quale componente possa essere responsabile, puoi procedere con una verifica più ampia disattivando temporaneamente i plugin e riattivandoli progressivamente.
La stessa logica può essere applicata al tema, soprattutto se il problema è comparso immediatamente dopo un aggiornamento o una modifica al codice.
Prima di intervenire su un sito di produzione è consigliabile disporre di un backup e, quando possibile, effettuare i test in staging.
WP_DEBUG e debug.log
WordPress integra un sistema di debug che può essere utile quando l’applicazione riesce effettivamente ad avviarsi.
Nel file wp-config.php puoi utilizzare:
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );
In questo modo WordPress può salvare gli errori nel file:
wp-content/debug.log
senza mostrarli ai visitatori.
Cerca in particolare:
- fatal error;
- memory exhausted;
- uncaught exception;
- errori relativi a plugin o tema;
- errori generati immediatamente prima del 502.
C’è però un limite importante.
Se il proxy non riesce a raggiungere PHP oppure il processo PHP termina prima che WordPress possa inizializzarsi correttamente, debug.log potrebbe non contenere la causa del 502.
In quel caso devi tornare ai log del web server e del runtime PHP.
Al termine della diagnosi disattiva il debug se non è più necessario e verifica che eventuali file di log non siano pubblicamente accessibili.
.htaccess: quando controllarlo e quando no
Il file .htaccess riguarda principalmente Apache e server compatibili con le sue direttive.
Se utilizzi esclusivamente Nginx, modificare .htaccess non risolve un problema della configurazione Nginx perché quest’ultimo non utilizza quel file.
Anche su Apache, inoltre, un .htaccess errato genera più frequentemente altre tipologie di errore.
Controllalo quindi se:
- hai Apache o uno stack compatibile;
- il file è stato modificato recentemente;
- i log suggeriscono un problema nelle direttive contenute al suo interno.
Non considerarlo una soluzione universale al 502.
Controlla memoria e processi PHP
Se i log indicano problemi di risorse, verifica:
- memory limit;
- processi PHP disponibili;
- worker occupati;
- processi terminati;
- chiamate HTTP esterne;
- cron job;
- plugin particolarmente pesanti;
- operazioni che producono picchi di carico.
Evita però di aumentare memoria, timeout e limiti PHP alla cieca.
Se il limite non è realmente la causa, aumentarlo non risolverà il problema e potrebbe soltanto renderne più difficile l’individuazione.
502 Bad Gateway con Nginx
La dicitura 502 Bad Gateway Nginx non significa automaticamente che Nginx sia guasto.
Molto spesso Nginx sta semplicemente segnalando che non è riuscito a ottenere dal backend la risposta necessaria.
Controlla quindi il suo error.log.
Tra i messaggi utili alla diagnosi possono esserci riferimenti a:
- upstream;
- connection refused;
- socket;
- FastCGI;
- connessione chiusa prematuramente;
- servizio backend non disponibile.
Se Nginx comunica con PHP attraverso FastCGI, verifica inoltre che il servizio PHP sia in esecuzione e che porta o socket configurati corrispondano realmente a quelli utilizzati dal runtime.
Per approfondire puoi leggere anche la nostra guida su Nginx, che include una sezione dedicata ad access.log ed error.log.
502 Bad Gateway con Cloudflare
Con Cloudflare bisogna distinguere il proxy dal server origin.
Il 502 può infatti provenire dall’origin oppure essere restituito nell’ambito della comunicazione tra Cloudflare e il server che ospita il sito.
La diagnosi deve quindi concentrarsi su:
- raggiungibilità dell’origin;
- stato del web server;
- log dell’origin;
- configurazione DNS;
- regole firewall;
- porte utilizzate;
- configurazione SSL/TLS;
- eventuali modifiche recenti all’infrastruttura.
Se utilizzi Cloudflare Tunnel, verifica anche che il servizio che gestisce il tunnel riesca effettivamente a raggiungere l’origin configurato.
La cosa importante è evitare di concludere automaticamente che “Cloudflare è down” soltanto perché la pagina di errore mostra il suo branding.
La documentazione ufficiale Cloudflare sul 502 e 504 permette di distinguere i problemi provenienti dall’origin da quelli generati dall’infrastruttura Cloudflare.
Il 502 Bad Gateway può danneggiare la SEO?
Un episodio breve di 502 Bad Gateway non comporta automaticamente una perdita di posizionamento.
Il problema diventa significativo quando gli errori server sono frequenti o persistono nel tempo.
Google tratta i codici 5xx, incluso il 502, come errori server.
In presenza di questi errori i crawler possono ridurre temporaneamente la frequenza di scansione. Gli URL già indicizzati vengono inizialmente mantenuti, ma se continuano a restituire errori server possono essere rimossi dall’indice.
Quando il server torna a rispondere correttamente con codici di successo, Google può aumentare progressivamente la frequenza di scansione.
Per questo la priorità SEO non è preoccuparsi di una presunta penalizzazione legata al bounce rate.
La priorità è molto più concreta:
ripristinare rapidamente risposte HTTP corrette e mantenere stabile l’accessibilità del sito per utenti e crawler.
Quando contattare il supporto hosting
Se non hai accesso al server o dai log emerge un problema infrastrutturale, è il momento di coinvolgere il provider.
Evita però segnalazioni generiche come:
“Il sito non funziona”.
Fornisci invece:
- il codice esatto: 502 Bad Gateway;
- URL coinvolti;
- orario in cui si è verificato;
- indicazione se interessa tutto il sito o solo alcune richieste;
- modifiche effettuate prima dell’errore;
- test già eseguiti;
- eventuali messaggi trovati nei log;
- indicazione se utilizzi CDN, proxy o firewall.
Con queste informazioni il tecnico può cercare direttamente nei log gli eventi corrispondenti e ridurre sensibilmente i tempi della diagnosi.
Se il problema riguarda WordPress e preferisci affidare l’analisi a un tecnico, puoi consultare il nostro servizio di assistenza WordPress e supporto tecnico.
Domande frequenti sul 502 Bad Gateway
Cosa significa Bad Gateway in italiano?
“Bad Gateway” significa letteralmente gateway non valido. In ambito HTTP indica che un server che opera come gateway o proxy ha ricevuto una risposta non valida dal server a monte necessario per completare la richiesta.
Cos’è l’errore 502 Bad Gateway?
È un codice di stato HTTP della famiglia 5xx. Compare quando un gateway o proxy non riesce a utilizzare correttamente la risposta ricevuta dal servizio upstream.
Il 502 dipende dal mio computer?
Normalmente no. Il 502 è principalmente un errore lato server o dell’infrastruttura di comunicazione tra server. VPN, proxy o particolari problemi di rete locale possono però interferire con la connessione e possono essere esclusi tramite alcuni test.
Qual è la differenza tra 502 e 504?
Il 502 Bad Gateway indica che il gateway o proxy ha ricevuto una risposta non valida dall’upstream. Il 504 Gateway Timeout indica invece che il gateway non ha ricevuto una risposta dall’upstream entro il tempo previsto.
Come risolvere un 502 Bad Gateway su WordPress?
Controlla prima i log del web server e del runtime PHP. Successivamente verifica modifiche recenti, plugin, tema, disponibilità dei processi PHP, CDN e configurazione del server. WP_DEBUG è utile quando WordPress riesce effettivamente a essere eseguito.
Cosa significa 502 Bad Gateway Nginx?
Significa che Nginx, mentre operava come gateway o proxy, non è riuscito a ottenere dal servizio upstream una risposta valida per completare la richiesta. La causa può trovarsi nel backend, nel runtime PHP, nel socket, nella porta o nella configurazione del proxy.
Cloudflare può mostrare un errore 502?
Sì. In una configurazione con Cloudflare il 502 può provenire dal server origin oppure dalla comunicazione tra proxy e origin. Per individuarne la causa bisogna controllare soprattutto raggiungibilità dell’origin, log, firewall, DNS, porte e configurazione SSL/TLS.
Un errore 502 può danneggiare il posizionamento su Google?
Un episodio breve non provoca automaticamente una perdita di ranking. Se gli errori 5xx persistono, Google può ridurre il crawling e, nel tempo, rimuovere dall’indice URL che continuano a restituire errori server.