nginx: upstream timed out (110: Connection timed out)

Come appare il messaggio

2026/10/29 09:14:02 [error] 1234#1234: *5678 upstream timed out (110: Connection timed out) while reading response header from upstream, client: 203.0.113.5, server: example.com, request: "POST /api/export HTTP/1.1", upstream: "fastcgi://unix:/run/php/php8.3-fpm.sock"

Cause frequenti

• La richiesta è semplicemente lenta: una query lunga, un export, un report o la chiamata a un'API esterna lenta.
• Tutti i worker PHP-FPM sono occupati (pm.max_children raggiunto) e le nuove richieste aspettano in coda.
• Il valore predefinito di fastcgi_read_timeout o proxy_read_timeout, 60 secondi, è più breve di quanto serve.
• Il backend si blocca, ad esempio in un deadlock o aspettando un file bloccato.
• Per “while connecting to upstream”: un problema di firewall o di rete tra nginx e il backend.

Verifica

1. Quale parte è scaduta? Leggi la fine della riga di log
   grep -i 'timed out' /var/log/nginx/error.log | tail -n 20Copia
2. Sono occupati tutti i worker PHP-FPM?
   grep -i 'max_children' /var/log/php8.3-fpm.log | tail -n 5Copia
3. Quanto impiega il backend per l'URL lento?
   curl -s -o /dev/null -w '%{time_total}s\n' https://example.com/api/exportCopia
4. Il backend è raggiungibile?
   systemctl status php8.3-fpmCopia

Soluzione

• Prima capisci perché la richiesta è lenta (database, API esterna) e risolvi quello. Un timeout più lungo nasconde solo il problema.
• Se il compito richiede davvero più tempo, alza il limite solo per quella location: fastcgi_read_timeout 300; o proxy_read_timeout 300;.
• Aumenta pm.max_children nel pool PHP-FPM se i worker sono il collo di bottiglia e la RAM lo permette.
• Sposta i lavori lunghi in background (cron, coda) e fai rispondere subito la pagina.
• Per “connecting to upstream”: controlla firewall e indirizzo del backend.

Domande frequenti

Ho alzato il timeout in nginx ma gli utenti vedono ancora un errore. Perché?

Altri livelli hanno limiti propri: il max_execution_time di PHP, un load balancer o una CDN. Cloudflare, per esempio, chiude la connessione dopo circa 100 secondi.

504 è la stessa cosa di 502?

No. 502 significa che il backend ha dato una risposta non valida o non era raggiungibile. 504 significa che non ha risposto in tempo.