errore 502 Bad Gateway indica che un gateway o proxy ha ricevuto una risposta non valida o incompleta dal servizio a monte.
Questa guida analizza errore 502 Bad Gateway con controlli progressivi, verifiche incrociate e modifiche reversibili. Non inviare password, cookie, token, chiavi private, codici 2FA o file di configurazione completi nei ticket.
Che cosa significa
Un gateway o proxy ha ricevuto una risposta non valida o incompleta dal servizio a monte.
Il messaggio visibile è soltanto il punto di partenza. Per interpretare correttamente errore 502 Bad Gateway bisogna identificare il sistema che ha prodotto il codice, confrontare l’orario con i log e distinguere una causa persistente da un evento temporaneo. Una diagnosi basata su dati riduce il rischio di modificare il componente sbagliato.
Come riconoscere il problema
- Il problema compare durante una operazione precisa e ripetibile.
- Il messaggio contiene un codice, un file, una riga o un server.
- Una seconda rete o sessione può produrre un risultato diverso.
- Il log dello stesso minuto contiene informazioni aggiuntive.
- Una modifica recente può aver cambiato il flusso della richiesta.
Cause più frequenti
1. Configurazione del server o proxy non coerente
Configurazione del server o proxy non coerente è una possibile origine di errore 502 Bad Gateway. Controlla questa ipotesi utilizzando il messaggio completo, l’orario e i dati del livello coinvolto. Non considerare sufficiente la vicinanza temporale con una modifica: verifica che il comportamento cambi quando la singola configurazione viene ripristinata o corretta.
2. Regole firewall, cdn o rate limit
Regole firewall, cdn o rate limit è una possibile origine di errore 502 Bad Gateway. Controlla questa ipotesi utilizzando il messaggio completo, l’orario e i dati del livello coinvolto. Non considerare sufficiente la vicinanza temporale con una modifica: verifica che il comportamento cambi quando la singola configurazione viene ripristinata o corretta.
3. Servizio a monte non disponibile
Servizio a monte non disponibile è una possibile origine di errore 502 Bad Gateway. Controlla questa ipotesi utilizzando il messaggio completo, l’orario e i dati del livello coinvolto. Non considerare sufficiente la vicinanza temporale con una modifica: verifica che il comportamento cambi quando la singola configurazione viene ripristinata o corretta.
4. Dns, porta o protocollo errati
Dns, porta o protocollo errati è una possibile origine di errore 502 Bad Gateway. Controlla questa ipotesi utilizzando il messaggio completo, l’orario e i dati del livello coinvolto. Non considerare sufficiente la vicinanza temporale con una modifica: verifica che il comportamento cambi quando la singola configurazione viene ripristinata o corretta.
5. Richiesta anomala o troppo frequente
Richiesta anomala o troppo frequente è una possibile origine di errore 502 Bad Gateway. Controlla questa ipotesi utilizzando il messaggio completo, l’orario e i dati del livello coinvolto. Non considerare sufficiente la vicinanza temporale con una modifica: verifica che il comportamento cambi quando la singola configurazione viene ripristinata o corretta.
6. Cache o stato client non aggiornato
Cache o stato client non aggiornato è una possibile origine di errore 502 Bad Gateway. Controlla questa ipotesi utilizzando il messaggio completo, l’orario e i dati del livello coinvolto. Non considerare sufficiente la vicinanza temporale con una modifica: verifica che il comportamento cambi quando la singola configurazione viene ripristinata o corretta.
Diagnosi passo per passo
- Registrare url, codice e orario. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
- Leggere header e corpo della risposta. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
- Controllare access log e log applicativi. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
- Confrontare origine e livello proxy. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
- Provare una sessione e una rete differenti. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
- Verificare dns, porte e servizi. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
- Riprodurre il caso minimo con curl. Esegui il controllo in sola lettura quando possibile e salva il risultato con data e ora. Confrontalo con una configurazione funzionante o con il valore precedente, quindi passa al punto successivo soltanto se il dato raccolto non spiega ancora l’errore.
Metodo sicuro di diagnosi
Prima di modificare la configurazione, registra il messaggio completo, la data e l’ora con fuso, l’URL o il servizio coinvolto, l’ultima modifica nota e il risultato ottenuto con un secondo strumento. Conserva Ray ID, Message-ID, request ID, transaction ID e codici applicativi quando presenti: questi identificativi collegano la schermata ai log senza richiedere password, cookie, token, chiavi private o codici di autenticazione.
Applica una sola modifica alla volta. Dopo ogni intervento ripeti la stessa operazione con gli stessi dati di test e controlla i log dello stesso intervallo temporale. Cambiare contemporaneamente DNS, cache, PHP, plugin, firewall, database e proxy impedisce di capire quale variazione abbia prodotto il risultato e rende più difficile un rollback affidabile.
Controllo incrociato dei livelli
Un errore visibile nel browser o nel client può essere generato da livelli differenti. Per il web confronta browser, curl, CDN, web server, PHP e applicazione. Per WordPress confronta frontend, wp-admin, Site Health, strumenti sviluppatore, WP-CLI e log. Per MySQL separa client, autenticazione, server, transazione e singola query. Per la posta confronta client, Webmail, coda SMTP, Track Delivery, DNS e risposta del destinatario.
Verifica sempre quale sistema ha prodotto il codice. Header, hostname, percorso del log, stack trace e testo esteso aiutano a distinguere un errore dell’edge da uno dell’origine, un rifiuto del proprio server da uno remoto e un problema PHP da uno del database. Questa distinzione evita interventi sul componente sbagliato.
Backup e reversibilità
Prima di cambiare file, record DNS, database, plugin o regole di sicurezza crea una copia leggibile e annota il valore precedente. Per i database usa backup coerenti e verifica che possano essere ripristinati. Per DNS registra TTL e nameserver autoritativi. Per firewall e proxy conserva l’espressione originale della regola. Una modifica reversibile consente di interrompere il test senza aggiungere un secondo guasto.
Non usare permessi 777, non disattivare globalmente WAF o antispam e non ridurre stabilmente la sicurezza TLS per ottenere una pagina funzionante. Le eccezioni devono essere limitate al percorso, parametro, hostname o sorgente confermati dai log.
Come raccogliere prove utili
Esporta testo e dati originali quando possibile: header HTTP, file .eml, bounce completo, output DNS, righe di log, stack trace e codici di risposta sono più utili di uno screenshot ritagliato. Oscura credenziali e dati personali, ma lascia visibili data, server, status, identificativi e descrizione tecnica dell’errore.
Ripeti il controllo con un caso minimo. Per una API usa pochi campi; per WordPress prova una funzione core; per MySQL usa una query in sola lettura o un campione; per la posta invia un messaggio di testo senza allegati. Aggiungi poi complessità progressivamente fino a individuare il punto nel quale compare il problema.
Interpretare cache, code e ritardi
Non tutti i cambiamenti diventano visibili immediatamente. DNS, cache CDN, cache LiteSpeed, sessioni PHP, connessioni persistenti, code SMTP e cron possono continuare a mostrare lo stato precedente. Verifica il TTL o la durata della cache, usa un nuovo identificativo di richiesta e controlla se il sistema sta elaborando una copia già accodata.
Un retry riuscito non annulla automaticamente l’errore precedente nei log. Confronta sempre l’identificativo della nuova richiesta con quello vecchio e verifica che il risultato sia relativo alla stessa URL, casella, query o operazione.
Verifica prolungata dopo la correzione
Una singola prova riuscita non dimostra che il problema sia definitivamente risolto. Ripeti l’operazione con una nuova sessione, un secondo utente o una seconda rete quando applicabile. Considera cache, TTL DNS, code SMTP, cron, lock, connessioni persistenti e processi pianificati.
Conserva temporaneamente backup, valori precedenti ed estratti dei log. Se l’anomalia ricompare, confronta l’orario con backup, aggiornamenti, rinnovi SSL, rotazioni DNS, picchi di traffico, importazioni e servizi esterni. Documenta causa, correzione e prova finale.
Procedura di risoluzione
- Correggere il servizio o la regola identificata. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
- Allineare dns, porta e protocollo. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
- Ridurre richieste o payload non necessari. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
- Applicare eccezioni soltanto mirate. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
- Pulire la cache della sola risorsa. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
- Aggiornare client, proxy o applicazione. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
- Monitorare nuove occorrenze dello stesso codice. Applica la correzione in modo mirato, conserva il valore precedente e ripeti immediatamente il test originale. Controlla lo stesso intervallo nei log e verifica che sicurezza, autenticazione, disponibilità e integrità dei dati siano rimaste operative.
Controlli finali
- Il test che generava errore 502 Bad Gateway ora completa correttamente.
- Il nuovo risultato è confermato da log o strumenti indipendenti.
- Non sono comparsi nuovi errori su funzioni collegate.
- Le protezioni di sicurezza restano attive e non esistono eccezioni globali.
- La configurazione finale e il rollback sono documentati.
Prevenzione
- Mantieni backup verificati prima di aggiornamenti e migrazioni.
- Monitora errori, risorse e scadenze con alert proporzionati.
- Documenta DNS, versioni e dipendenze senza memorizzare password in chiaro.
- Prova modifiche importanti in staging e applicale una alla volta.
- Rivedi periodicamente regole, plugin, client e servizi non più utilizzati.
Errori da evitare
- Non disattivare globalmente firewall, WAF, antispam o verifica TLS.
- Non usare permessi 777 e non aumentare limiti senza misurare la causa.
- Non ripetere continuamente la stessa operazione quando può creare duplicati o ulteriore carico.
- Non condividere password, token, cookie, chiavi private o file di configurazione completi.
- Non chiudere l’intervento dopo una sola prova senza controllare log, cache, code e ricorrenza.
Quando contattare l’assistenza Xlogic
Apri un ticket quando il problema persiste dopo i controlli di base, coinvolge più servizi oppure richiede log e configurazioni non disponibili nel pannello. Indica:
- dominio, hostname o servizio coinvolto;
- data e ora con fuso;
- messaggio completo e codice;
- identificativi tecnici disponibili;
- controlli già eseguiti e modifiche recenti.
Non inviare credenziali. I dati tecnici sopra indicati sono sufficienti per iniziare la diagnosi.
Fonti tecniche ufficiali
Domande frequenti su errore 502 Bad Gateway
Che cosa indica errore 502 Bad Gateway?
Un gateway o proxy ha ricevuto una risposta non valida o incompleta dal servizio a monte.
Qual è il primo controllo da eseguire?
Registra il messaggio completo e poi registrare URL, codice e orario, senza modificare più componenti contemporaneamente.
È corretto disattivare protezioni o aumentare limiti?
No. Una misura temporanea serve soltanto come test controllato; la soluzione definitiva deve correggere la causa e mantenere operative le protezioni.
Quali dati servono all’assistenza?
Indica dominio o servizio, orario, errore completo, identificativi tecnici e controlli già eseguiti, senza inviare password, token o chiavi private.
Come verificare che il problema sia risolto?
Ripeti l’operazione originale, controlla i log e conferma che sia possibile monitorare nuove occorrenze dello stesso codice senza nuovi errori.