Error 502 Bad Gateway: Cos'è e Come Risolverlo Guida Pratica

Dom, 10/08/2025 - 08:00

Stai navigando tranquillamente sul web, clicchi su un link e, invece della pagina desiderata, vieni accolto da una schermata bianca con un messaggio criptico: "Error 502 Bad Gateway". È un'esperienza frustrante e comune, che lascia sia gli utenti che i proprietari dei siti web a chiedersi cosa sia andato storto.

Questo codice di stato HTTP, talvolta cercato in Italia anche come "errore 502", indica un problema di comunicazione tra server su Internet. Per una panoramica su tutti i problemi di questo tipo, puoi consultare la nostra Guida completa agli errori del server web.
La sua origine può essere difficile da diagnosticare, ma sei nel posto giusto. Questa guida completa ti spiegherà che cosa significa l'error 502, analizzerà le cause più comuni e, soprattutto, ti fornirà soluzioni pratiche per risolverlo, che tu sia un semplice utente o l'amministratore del sito.

1. Cos'è l'Error 502 Bad Gateway? Spiegazione Semplice

Immagina di ordinare un caffè al bar. Tu (il tuo browser) fai la richiesta al cameriere (il server gateway o proxy). Il cameriere va in cucina (il server di origine) per preparare l'ordine, ma riceve una risposta non valida o nessuna risposta. Il cameriere torna da te e ti dice: "Spiacente, c'è un problema in cucina".

L'Error 502 Bad Gateway funziona esattamente così. Il tuo browser si connette a un server intermedio (un "gateway", come un reverse proxy Nginx o una CDN Cloudflare) che a sua volta cerca di contattare il server principale dove risiede il sito. Se il server principale restituisce una risposta non valida o è irraggiungibile, il gateway non sa cosa fare e ti mostra il temuto Error 502.

1.1 Le diverse facce dell'Error 502

Potresti incontrare questo errore sotto vari nomi, ma il problema di fondo è lo stesso:

Error 502
502 Bad Gateway
HTTP Error 502 - Bad Gateway
502 Service Temporarily Overloaded
502 Proxy Error
Una schermata bianca vuota
502 Bad Gateway Cloudflare: una pagina di errore specifica mostrata dalla popolare CDN.

2. Le Cause Principali dell'Error 502

Le cause di un error 502 sono quasi sempre lato server. Ecco le più comuni:

Sovraccarico del Server di Origine: Il server che ospita il sito web è sommerso da un picco di traffico o da uno script che consuma troppe risorse (CPU/RAM) e non riesce a rispondere alle richieste. Questa stessa causa è spesso all'origine di un altro problema comune, l'Error 503 Service Unavailable
Il Server è Offline o Irraggiungibile: Il server di origine potrebbe essere spento per manutenzione, a causa di un guasto hardware o per problemi di rete.
Configurazione Errata del Firewall: Un firewall troppo aggressivo, sia sul server di origine che su servizi come Cloudflare, potrebbe bloccare erroneamente le richieste legittime provenienti dal gateway.
Errori PHP o Timeout: In stack LAMP/LEMP, uno script PHP (es. di WordPress o un altro CMS) potrebbe andare in crash o impiegare troppo tempo per essere eseguito. Servizi come PHP-FPM possono andare in timeout o smettere di funzionare, lasciando Nginx senza una risposta da inoltrare.
Problemi di Risoluzione DNS: Il gateway potrebbe non riuscire a risolvere il dominio del server di origine al corretto indirizzo IP a causa di problemi DNS.
Comunicazione interrotta tra Origine e CDN: Una pagina di errore 502 Cloudflare mostra che il problema risiede nel tuo server di origine, mentre una pagina completamente bianca indica che l'errore ha origine da Cloudflare stesso.

3. Come Risolvere l'Error 502: La Guida Pratica

3.1 Soluzioni per l'Utente del Sito

Se incontri un error 502 su un sito che non gestisci, le tue opzioni sono limitate ma vale la pena provare questi passaggi prima di arrendersi.

Ricarica la pagina (F5 o Ctrl+R): Sembra banale, ma spesso il problema è temporaneo. Attendi un minuto e ricarica.
Svuota la cache del browser: Il tuo browser potrebbe aver salvato una versione "rotta" della pagina. Svuota la cache e i cookie e riprova.
Usa un altro browser o la modalità in incognito: Questo aiuta a escludere problemi legati a estensioni o alla cache del browser.
Controlla se il sito è down per tutti: Usa strumenti online come "Down for Everyone or Just Me" per verificare se il problema è solo tuo o generale.
Riavvia i tuoi dispositivi di rete: Spegni e riaccendi il tuo modem/router per escludere problemi di connessione locali.

3.2 Soluzioni per Sviluppatori e Amministratori di Sistema

Se l'error 502 si verifica sul tuo sito, è il momento di rimboccarsi le maniche. Ecco una checklist di troubleshooting tecnico.

Controlla i Log degli Errori: Questa è la prima e più importante azione. Controlla i log di Nginx (/var/log/nginx/error.log), Apache (/var/log/apache2/error.log) e delle tue applicazioni (es. log di PHP-FPM). Cercheranno messaggi come "connect() failed", "upstream sent too big header" o "Connection refused".
Verifica lo Stato dei Servizi: Assicurati che tutti i servizi necessari siano in esecuzione. In uno stack LEMP, controlla Nginx e PHP-FPM.
```
sudo systemctl status nginx
sudo systemctl status php8.2-fpm  # La versione potrebbe cambiare
```
Se un servizio è fermo, riavvialo (sudo systemctl restart nginx) e monitora i log per vedere se il problema si ripresenta.
Risoluzione Problemi PHP-FPM: Un colpevole comune è PHP-FPM che smette di funzionare o è sovraccarico. Potrebbe essere necessario aumentare il numero di "child processes" nel file di configurazione del pool (es. /etc/php/8.2/fpm/pool.d/www.conf) o aumentare il `request_terminate_timeout`.
Ispeziona la Configurazione del Firewall: Controlla le regole del firewall del tuo server (es. `ufw`, `iptables`) e della tua CDN (es. Cloudflare) per assicurarti che non stiano bloccando le connessioni tra i tuoi server o dalla CDN stessa.
Analisi delle Risorse del Server: Usa comandi come top, htop o free -m per controllare l'utilizzo di CPU e RAM. Un picco improvviso potrebbe indicare un processo fuori controllo. Potrebbe essere necessario scalare le risorse del tuo server su Google Cloud Platform o un altro provider.
Troubleshooting della CDN (Cloudflare): Se usi Cloudflare, prova a metterlo in "Development Mode" o a "metterlo in pausa". Questo farà sì che il traffico vada direttamente al tuo server di origine. Se l'errore scompare, il problema è nella comunicazione tra Cloudflare e il tuo server. Controlla che gli IP di Cloudflare siano nella whitelist del tuo firewall.
Verifica la Risoluzione DNS: Assicurati che il dominio risolva correttamente all'IP del server di origine, sia a livello pubblico che nella configurazione del tuo gateway/proxy.

4. Quando il Problema è l'Infrastruttura: Prevenire gli Error 502

Risolvere un error 502 è un conto, prevenirlo è un altro. Spesso, errori ricorrenti sono il sintomo di un'infrastruttura fragile o mal configurata: server sottodimensionati, configurazioni di Nginx o Apache non ottimizzate, gestione inefficiente dei processi PHP, o una strategia di caching inefficace.

Come consulente specializzato in infrastrutture cloud (Google Cloud Platform, Proxmox PVE) e ottimizzazione di web server (Nginx, Apache, Linux), aiuto le PMI di sviluppo a costruire architetture resilienti, capaci di gestire picchi di traffico e di prevenire proattivamente errori come il 502.

Smetti di rincorrere gli errori. Richiedi una consulenza sulla tua infrastruttura cloud e costruiamo insieme una soluzione stabile, performante e che ti lasci dormire sonni tranquilli.

5. Domande Frequenti (FAQ)

Un Error 502 danneggia la SEO del mio sito?: Un errore occasionale e risolto rapidamente non avrà impatti. Tuttavia, se l'Error 502 persiste per ore o giorni, Google potrebbe de-indicizzare temporaneamente le tue pagine, interpretando il sito come inaffidabile. È fondamentale risolvere il problema il prima possibile.
L'Error 502 è colpa mia o del sito?: Nel 99% dei casi, è un problema del sito web (lato server). È molto raro che dipenda dalla tua connessione o dal tuo computer, ma seguire i passaggi della sezione 4.1 aiuta a escludere ogni dubbio.
Cosa significa "Bad Gateway" in parole semplici?: Significa "portale difettoso". Indica che il server a cui ti sei connesso inizialmente (il portale) non è riuscito a ottenere una risposta valida da un altro server da cui dipendeva per completare la tua richiesta.

6. Conclusione: Trasformare un Errore in un'Opportunità

L'Error 502 Bad Gateway, sebbene fastidioso, è un'opportunità per analizzare e rafforzare la propria infrastruttura web. Per l'utente, è spesso un problema passeggero. Per lo sviluppatore o l'amministratore di sistema, è un chiaro segnale che qualcosa nella catena di comunicazione si è interrotto.

Affrontarlo in modo metodico, partendo dai log e analizzando ogni componente — dal firewall al server web, fino ai processi applicativi — è la chiave per una risoluzione rapida ed efficace. E, soprattutto, è il primo passo per costruire un'architettura più robusta e prevenire che l'errore si ripresenti in futuro.

Orario