Errore 502 Bad Gateway: cause, controlli e soluzioni

In breve: Errore 502 Bad Gateway: cause, controlli e soluzioni: L’errore 502 Bad Gateway indica che un server usato come gateway o proxy ha ricevuto una risposta non valida dal servizio a monte.

Errore 502 Bad Gateway: cause, controlli e soluzioni

Questa guida approfondisce errore 502 Bad Gateway con una procedura progressiva e reversibile. Non inviare password, codici 2FA, token, chiavi private o file di configurazione completi nei ticket.

Che cosa significa

Il codice 502 non identifica automaticamente un guasto del server hosting. Può essere generato da una CDN, da un reverse proxy, dal web server o da un’applicazione che termina la connessione in modo inatteso.

Per una diagnosi corretta bisogna stabilire quale componente ha prodotto la pagina di errore e confrontare l’orario con log applicativi, error_log, modifiche recenti e stato delle risorse.

Come riconoscere il problema

• Il sito mostra 502 su tutte le pagine o soltanto in alcune operazioni.
• Il problema compare durante importazioni, backup, aggiornamenti o richieste API.
• Bypassando Cloudflare o la CDN il comportamento cambia.
• Il 502 è intermittente e scompare ricaricando la pagina.
• Frontend e wp-admin possono avere esiti diversi.

Cause più frequenti

1. Processo PHP terminato o non raggiungibile

Il web server può non ricevere una risposta valida dal processo PHP a causa di crash, riavvio, timeout interno o errore fatale. Verifica questa ipotesi usando il messaggio completo e i dati dell’orario interessato, senza basarti soltanto sul testo mostrato dal browser o dall’applicazione.

2. Applicazione sovraccarica

Query lente, plugin pesanti, richieste simultanee o processi bloccati possono impedire all’applicazione di rispondere correttamente.

3. Proxy o CDN

Cloudflare, un reverse proxy o un bilanciatore può ricevere una risposta vuota, interrotta o non conforme dal server di origine.

4. Plugin, tema o codice personalizzato

Un componente aggiornato di recente può chiudere la risposta, produrre output anomalo o richiedere servizi esterni non disponibili.

5. Problema DNS verso l’origine

La CDN può contattare un indirizzo IP vecchio o un server che non ospita più il sito.

6. Manutenzione o riavvio temporaneo

Aggiornamenti di sistema, riavvii di servizi o interventi sull’applicazione possono produrre un errore breve e isolato.

Diagnosi passo per passo

1. Identifica chi genera il 502. Controlla logo, intestazioni HTTP e contenuto della pagina per capire se l’errore proviene da Cloudflare, LiteSpeed, un proxy o dall’applicazione. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.
2. Registra URL e orario. Annota l’indirizzo esatto, l’operazione eseguita e l’ora al minuto per confrontare i log. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.
3. Controlla error_log. Cerca fatal error, processi terminati, memoria esaurita, timeout, connessioni al database e percorsi di plugin o tema. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.
4. Verifica le risorse. Controlla CPU, memoria, processi simultanei, I/O e limiti CloudLinux nell’intervallo interessato. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.
5. Prova senza cache applicativa. Svuota soltanto le cache pertinenti dopo aver conservato lo stato e ripeti il test senza disattivare globalmente la sicurezza. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.
6. Confronta origine e CDN. Quando tecnicamente possibile, verifica la risposta dell’origine con hostname corretto senza cambiare pubblicamente i DNS. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.
7. Riduci l’operazione. Ripeti con un import più piccolo, una richiesta semplice o il componente sospetto disattivato in staging. Salva il risultato e confrontalo con il passaggio successivo; in questo modo potrai distinguere una causa locale da una configurazione del servizio.

Procedura di risoluzione

1. Correggi l’errore applicativo. Intervieni sul file, plugin, tema o query indicati dal registro invece di aumentare limiti senza diagnosi. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.
2. Riduci il carico. Suddividi importazioni, backup e operazioni massive in batch più piccoli. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.
3. Aggiorna componenti incompatibili. Usa versioni compatibili di WordPress, plugin, tema e PHP, dopo backup e test. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.
4. Verifica l’indirizzo di origine. Assicurati che CDN e proxy contattino l’IP corretto e che il certificato dell’origine sia valido. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.
5. Controlla timeout e servizi esterni. Riduci dipendenze lente e gestisci correttamente errori delle API. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.
6. Ripristina la modifica recente. Se il problema è iniziato subito dopo un intervento, torna alla configurazione precedente verificata. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.
7. Contatta l’assistenza con dati precisi. Fornisci URL, orario, IP pubblico e messaggio del log quando il problema coinvolge servizi non gestibili dal pannello. Dopo la modifica ripeti lo stesso test, controlla il log e verifica che non siano comparsi effetti collaterali.

Guide Xlogic correlate

• Errore 504 Gateway Timeout: cause e soluzioni
• Errore 504 Gateway Timeout: diagnosi e soluzioni
• PHP .user.ini non applicato: cause e controlli

Fonti tecniche

• MDN: 502 Bad Gateway