In breve: Errore 504 Gateway Timeout: cause e soluzioni: errore 504 Gateway Timeout: l’errore 504 Gateway Timeout indica che un server intermedio, come un proxy, una CDN o un gateway, non ha ricevuto in tempo la risposta dal servizio a monte.
Indice dei contenuti
Errore 504 Gateway Timeout: cause e soluzioni
L’errore 504 Gateway Timeout indica che un server intermedio, come un proxy, una CDN o un gateway, non ha ricevuto in tempo la risposta dal servizio a monte. Il browser mostra il 504, ma la causa può trovarsi nell’applicazione, in PHP, nel database, in una chiamata API esterna o nel server di origine.
Un singolo 504 può essere temporaneo. Se l’errore si ripete, annota l’URL, l’operazione eseguita e l’orario preciso: questi dati permettono di confrontare la richiesta con i log senza aumentare i timeout alla cieca.
In sintesi
- Riprova una sola volta dopo alcuni minuti e verifica se il problema riguarda una pagina o tutto il sito.
- Controlla lo stato dei servizi e l’utilizzo di CPU, memoria, processi, I/O e database.
- Consulta
error_loge i log dell’applicazione nello stesso minuto dell’errore. - Se il problema nasce durante importazioni, backup o chiamate esterne, riduci il carico e individua l’operazione lenta.
- Non aumentare indiscriminatamente timeout e limiti: potresti nascondere la causa senza risolverla.
Che cosa significa l’errore 504
Il codice HTTP 504 viene restituito da un componente che sta aspettando la risposta di un altro sistema. Per esempio, una CDN può attendere il server di origine, il web server può attendere PHP oppure l’applicazione può attendere il database o un’API esterna.
Per questo motivo il testo “Gateway Timeout” non identifica automaticamente il componente guasto. La diagnosi deve stabilire quale livello ha generato il codice e quale servizio non ha risposto entro il tempo previsto.
Differenza tra 502, 503 e 504
| Codice | Significato pratico | Primo controllo |
|---|---|---|
| 502 Bad Gateway | Il gateway ha ricevuto una risposta non valida dal servizio a monte. | Log del proxy, PHP e applicazione. |
| 503 Service Unavailable | Il servizio non è disponibile o non può gestire temporaneamente la richiesta. | Stato del servizio, manutenzione e risorse. |
| 504 Gateway Timeout | Il servizio a monte non ha risposto entro il tempo previsto. | Durata della richiesta, query, processi e dipendenze esterne. |
Cause più frequenti
Script PHP o operazione applicativa lenta
Importazioni, esportazioni, generazione di archivi, elaborazione di immagini e operazioni massive possono superare il tempo disponibile. Il log PHP può indicare fatal error, memoria esaurita oppure il punto nel quale l’esecuzione si interrompe.
Query lente o database sotto carico
Una query non indicizzata, una tabella molto grande, un lock o numerose operazioni simultanee possono ritardare la risposta. Verifica se l’errore compare solo in pagine che leggono o aggiornano molti dati.
Plugin o tema WordPress
Se il 504 è iniziato dopo un aggiornamento, un plugin può eseguire chiamate lente, cron, scansioni o query costose. Il test corretto consiste nell’isolare un componente alla volta, preferibilmente in staging o durante una finestra controllata.
API o servizi esterni non raggiungibili
Gateway di pagamento, feed, servizi di spedizione, sistemi gestionali e API remote possono non rispondere. In questo caso il sito resta in attesa anche se il server locale è operativo.
Risorse dell’account esaurite
Su hosting con CloudLinux controlla CPU, memoria, processi simultanei, I/O e IOPS. Un superamento può rallentare o interrompere le richieste, soprattutto durante picchi, backup o attività automatiche.
Proxy, CDN o firewall
Una CDN o un reverse proxy può avere un timeout inferiore a quello dell’origine. Prima di modificare i valori confronta la risposta diretta dell’origine con quella ottenuta attraverso il proxy e controlla gli header che identificano il sistema che ha prodotto il 504.
Diagnosi passo per passo
- Annota URL, data e ora. Indica anche l’azione precisa: apertura pagina, salvataggio, importazione, chiamata API o attività pianificata.
- Definisci l’ambito. Verifica se l’errore riguarda una sola pagina, tutto il sito, wp-admin, un singolo utente o una sola rete.
- Controlla lo stato dei servizi. Se più siti o funzioni risultano coinvolti, verifica eventuali manutenzioni o anomalie generali.
- Consulta Utilizzo risorse. In cPanel apri, quando disponibile, Metriche → Utilizzo risorse e confronta l’orario con eventuali fault.
- Leggi i log. Controlla la sezione Errori di cPanel, il file
error_loge i log dell’applicazione nello stesso intervallo. - Riproduci un caso minimo. Riduci il numero di record, la dimensione del file o la complessità dell’operazione per capire quale soglia fa comparire il problema.
- Controlla le modifiche recenti. Verifica aggiornamenti, plugin, tema, regole CDN, cron, integrazioni e variazioni del database.
- Applica una sola correzione. Ripeti lo stesso test e conserva il valore precedente per poter effettuare il rollback.
Controlli in cPanel e CloudLinux
In cPanel controlla la sezione Metriche, il consumo di spazio e i registri degli errori. Se è disponibile CloudLinux, i fault di CPU, memoria, processi, I/O e IOPS aiutano a capire se la richiesta è stata rallentata da un limite dell’account.
Un fault isolato non prova da solo la causa. Deve coincidere con l’orario del 504 e con l’operazione che lo genera. Se il limite viene raggiunto durante un backup o un’importazione, esegui il lavoro in blocchi più piccoli o in un orario con meno traffico.
Controlli specifici per WordPress
- Verifica se il problema è iniziato dopo l’aggiornamento di plugin, tema o core.
- Controlla cron, backup, scansioni di sicurezza, importazioni e processi WooCommerce.
- Consulta
wp-content/debug.logsolo se il debug è configurato in modo sicuro e non visibile ai visitatori. - Se wp-admin non è accessibile, rinomina temporaneamente solo la cartella del plugin sospetto tramite Gestione file.
- Controlla eventuali chiamate esterne lente con gli strumenti di diagnostica disponibili.
Operazioni pesanti e servizi esterni
Il 504 compare spesso durante importazioni di prodotti, backup completi, scansioni, aggiornamenti massivi, elaborazione di immagini o sincronizzazioni. Prova un campione più piccolo e verifica se il tempo cresce con il volume dei dati.
Quando è coinvolta un’API esterna, conserva il codice della richiesta, l’orario e l’eventuale identificativo fornito dal servizio. Non inviare token, password o chiavi private nel ticket.
Domande frequenti
Che cosa indica l’errore 504 Gateway Timeout?
Il 504 indica che un componente intermedio, come proxy o web server, ha atteso troppo a lungo la risposta di un sistema a monte. La causa può trovarsi in PHP, database, API esterne, risorse dell’account o infrastruttura di proxy/CDN.
Quali controlli fare per diagnosticare un errore 504?
Annota URL, orario e operazione che genera il timeout, verifica se il problema è generale o limitato a una pagina e controlla risorse, log, PHP, database e servizi esterni coinvolti nello stesso intervallo temporale.
Guide Xlogic correlate
- Errore 502 Bad Gateway: cause e soluzioni
- Errore 409 Conflict: cause e soluzioni
- Errore 429 Too Many Requests: cause e soluzioni