Come appare il messaggio
2026/10/29 11:20:45 [error] 1234#1234: *4521 upstream prematurely closed connection while reading response header from upstream, client: 203.0.113.5, server: example.com, request: "POST /api/export HTTP/2.0", upstream: "http://127.0.0.1:8080/api/export"Cause frequenti
- Il processo del backend è andato in crash o è stato terminato durante la richiesta (segfault, kill per memoria esaurita, worker riciclato dopo un limite di richieste).
- Il backend è stato riavviato o ricaricato proprio in quel momento, per esempio da un deploy o da un service manager.
- Un conflitto di protocollo:
proxy_pass http://verso una porta che si aspetta HTTPS, oppurefastcgi_passverso una porta HTTP semplice. - Il backend chiude le connessioni keepalive inattive prima che nginx le riusi.
- Il backend rifiuta la richiesta, per esempio per un header o un body troppo grande, e chiude la connessione.
Verifica
- Quanto spesso e per quali URL
grep 'prematurely closed' /var/log/nginx/error.log | tail -n 10 - Il backend è caduto o riavviato? (esempio PHP-FPM)
- Il kernel ha terminato un processo?
sudo dmesg -T | grep -iE 'out of memory|killed process|segfault' | tail -n 10 - Il backend risponde direttamente? (adatta la porta)
curl -sv -o /dev/null http://127.0.0.1:8080/
Soluzione
- Scopri perché il backend muore: leggi il suo log e quello del kernel e correggi prima crash o esaurimento della memoria.
- Controlla lo schema:
proxy_pass https://...per un backend TLS,fastcgi_passsolo per socket o porte FastCGI. - Se usi keepalive verso il backend, imposta il timeout di inattività del backend più alto del
keepalive_timeoutdi nginx nel bloccoupstream. - Evita di riavviare il backend sotto carico: nei deploy usa un reload graduale (
systemctl reload ...). - Testa e applica:
nginx -t && systemctl reload nginx.
Scenario tipico
Il tuo servizio PHP genera fatture in PDF. Per certi clienti nginx risponde 502, nel log degli errori c'è "upstream prematurely closed connection while reading response header from upstream" e nello stesso momento nel log di PHP-FPM "child 1234 exited on signal 11 (SIGSEGV)". Un'estensione PHP va in crash con quei dati. Confronta gli orari nei due log prima di modificare la configurazione di nginx, perché qui nginx segnala solo il sintomo.
Domande frequenti
In cosa differisce da 111 Connection refused?
Con 111 nessuno è in ascolto sulla porta. Qui la connessione è stata accettata e poi chiusa senza risposta, quindi il processo è attivo ma fallisce o si disconnette.
Perché succede solo su alcune richieste?
Di solito sono proprio quelle richieste a causare il crash o a superare un limite, per esempio un export o un upload grosso. Confronta gli URL che falliscono nel log.
Come capisco che il backend è andato in crash?
Il log del backend di solito lo dice: con PHP-FPM "exited on signal 11" o "exited on signal 9 (SIGKILL)", con Gunicorn "Worker … was sent SIGKILL". Un segnale 9 nello stesso momento fa spesso pensare all'OOM killer, che confermi con journalctl -k o dmesg.
nginx ripete la richiesta su un altro server?
Dipende da proxy_next_upstream. Per impostazione predefinita nginx riprova in caso di errori e timeout, ma solo se sono definiti più server upstream. Le richieste POST non vengono ripetute senza l'opzione non_idempotent, così nulla viene eseguito due volte.
Perché è un 502 e non un 504?
Un 504 nasce quando il backend tace troppo a lungo. Qui il backend ha chiuso la connessione, volontariamente o per un crash, prima di poter rispondere. nginx vede una fine prematura, non un timeout, e quindi restituisce 502 Bad Gateway.