So sieht die Meldung aus
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"Häufige Ursachen
- Der Backend-Prozess ist während der Anfrage abgestürzt oder beendet worden (Segfault, Out-of-Memory-Kill, ein Worker nach einem Anfragelimit neu gestartet).
- Das Backend wurde genau dann neu gestartet oder neu geladen, zum Beispiel durch ein Deployment oder einen Dienstmanager.
- Ein Protokollkonflikt:
proxy_pass http://auf einen Port, der HTTPS erwartet, oderfastcgi_passauf einen reinen HTTP-Port. - Das Backend schließt ruhende Keepalive-Verbindungen früher, als nginx sie wiederverwendet.
- Das Backend lehnt die Anfrage ab, zum Beispiel wegen eines zu großen Headers oder Bodys, und trennt die Verbindung.
Prüfen
- Wie oft und bei welchen URLs
grep 'prematurely closed' /var/log/nginx/error.log | tail -n 10 - Ist das Backend abgestürzt oder neu gestartet? (Beispiel PHP-FPM)
- Hat der Kernel einen Prozess beendet?
sudo dmesg -T | grep -iE 'out of memory|killed process|segfault' | tail -n 10 - Antwortet das Backend direkt? (Port anpassen)
curl -sv -o /dev/null http://127.0.0.1:8080/
Lösung
- Herausfinden, warum das Backend stirbt: dessen eigenes Log und das Kernel-Log lesen, zuerst Abstürze oder Speichermangel beheben.
- Das Schema prüfen:
proxy_pass https://...für ein TLS-Backend,fastcgi_passnur für FastCGI-Sockets oder -Ports. - Wird Keepalive zum Backend genutzt, den Idle-Timeout des Backends höher als nginx'
keepalive_timeoutimupstream-Block setzen. - Das Backend nicht unter Last neu starten: bei Deployments einen sanften Reload (
systemctl reload ...) nutzen. - Testen und anwenden:
nginx -t && systemctl reload nginx.
Typisches Szenario
Dein PHP-Dienst erzeugt PDF-Rechnungen. Bei bestimmten Kunden antwortet nginx mit 502, im Fehlerlog steht „upstream prematurely closed connection while reading response header from upstream“, und zeitgleich im PHP-FPM-Log „child 1234 exited on signal 11 (SIGSEGV)“. Eine PHP-Erweiterung stürzt bei diesen Daten ab. Vergleiche die Zeitstempel in beiden Logs, bevor du an der nginx-Konfiguration änderst, denn nginx meldet hier nur das Symptom.
Häufige Fragen
Wie unterscheidet sich das von 111 Connection refused?
Bei 111 lauscht nichts auf dem Port. Hier wurde die Verbindung angenommen und dann ohne Antwort geschlossen, der Prozess läuft also, scheitert aber oder trennt.
Warum passiert es nur bei manchen Anfragen?
Meist lösen genau diese Anfragen den Absturz aus oder überschreiten ein Limit, zum Beispiel ein großer Export oder Upload. Vergleiche die fehlschlagenden URLs im Log.
Woran erkenne ich, dass das Backend abgestürzt ist?
Im Log des Backends steht meist ein Hinweis: bei PHP-FPM „exited on signal 11“ oder „exited on signal 9 (SIGKILL)“, bei Gunicorn „Worker … was sent SIGKILL“. Signal 9 zur selben Zeit deutet oft auf den OOM-Killer, den du mit journalctl -k oder dmesg bestätigst.
Wiederholt nginx die Anfrage bei einem anderen Server?
Das hängt von proxy_next_upstream ab. Standardmäßig versucht nginx es bei Fehlern und Timeouts erneut, aber nur wenn mehrere Upstream-Server definiert sind. POST-Anfragen werden ohne die Option non_idempotent nicht wiederholt, damit nichts doppelt ausgeführt wird.
Warum ist es ein 502 und kein 504?
Ein 504 entsteht, wenn das Backend zu lange schweigt. Hier hat das Backend die Verbindung aktiv oder durch einen Absturz beendet, bevor es antworten konnte. Nginx sieht also ein vorzeitiges Ende, keine Zeitüberschreitung, und liefert daher 502 Bad Gateway.