Cosa significa
Un gateway o un proxy non ha ricevuto in tempo una risposta dal server upstream.
Cause comuni
- Query al database o chiamate ad API esterne lente
- Timeout del proxy più breve del tempo di elaborazione
- Server upstream irraggiungibile per problemi di rete
Come risolvere
Lato client o visitatore
Riprova più tardi; per operazioni lunghe, chiedi se l'API offre un'elaborazione asincrona.
Lato gestore del sito o dell’API
Velocizza il percorso lento o spostalo in un job in background; alza i timeout del proxy (proxy_read_timeout) solo a valori realistici.
Risposta di esempio
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0Specifica
Domande frequenti
› Come risolvo il 504 Gateway Timeout in nginx?
Scopri perché l'upstream è lento; se le richieste lunghe sono previste, alza insieme proxy_read_timeout e il timeout del server dell'app.
› Chi restituisce il 504, la mia app o il proxy?
Il proxy, il load balancer o la CDN davanti alla tua app, dopo averla attesa troppo a lungo.