Un errore 504 Gateway Timeout significa che un gateway non ha ricevuto in tempo la risposta dal servizio a monte. Occorre capire dove si accumula l’attesa, non aumentare subito tutti i timeout.
Indice dei contenuti
Come risolvere il problema
Annota quale operazione fallisce e dopo quanti secondi. Un problema limitato a un’esportazione suggerisce controlli diversi da un errore presente su tutte le pagine. La risposta del browser non dimostra che il processo sul server si sia fermato.
Se stavi pagando, inviando un ordine o avviando un’importazione, verifica prima l’esito nell’applicazione. Ripetere la richiesta potrebbe avviare due volte lo stesso lavoro.
Procedura passo per passo
- Conserva orario, URL, metodo e intestazioni utili della risposta, oscurando token e dati personali.
- Identifica il gateway: CDN, proxy o server web. Confronta i suoi log con quelli del servizio a monte nello stesso intervallo.
- Controlla se PHP è bloccato, se il database attende una risorsa o se una chiamata esterna rallenta la richiesta. Una pagina 504 non identifica da sola il componente responsabile.
- Se l’operazione è legittimamente lunga, valuta con lo sviluppatore un lavoro in background e una pagina che ne mostri l’avanzamento.
- Correggi il ritardo rilevato e ripeti una prova controllata. Su hosting condiviso chiedi al supporto la verifica dei log o dei limiti che non puoi consultare.
Guide Xlogic correlate
- Errore 408 Request Timeout: cause e soluzioni
- WordPress cURL error 28: timeout e richieste HTTP
- Errore 502 Bad Gateway: cause, controlli e soluzioni
Domande frequenti
Che cosa significa errore 504 Gateway Timeout?
Il 504 viene restituito quando un gateway o proxy non riceve una risposta dal servizio a monte entro il tempo previsto. Per risolverlo bisogna capire quale backend è lento o non risponde, non limitarsi ad aumentare il timeout.
Quali controlli fare per diagnosticare un 504?
Riproduci la richiesta, annota codice e intestazioni e controlla i log nello stesso intervallo di tempo. Verifica poi quale componente fa da gateway e quale servizio upstream dovrebbe rispondere.
Aumentare il timeout risolve sempre l’errore 504?
No. Può mascherare temporaneamente il sintomo, ma se il backend è bloccato, sovraccarico o esegue operazioni troppo lente il problema resta. La soluzione corretta è individuare e correggere la causa del ritardo.