Geprüft
2026-11-14
/ 502 Bad Gateway

502 Bad Gateway: nginx läuft, die Anwendung dahinter nicht.

Ein 502 von nginx heißt: nginx selbst läuft, hat aber von dem, was dahinter sitzt, keine brauchbare Antwort bekommen. Das ist PHP-FPM, eine Node- oder Python-Anwendung oder ein weiterer Proxy. Welches davon, steht im Fehlerlog, meist in einer einzigen Zeile.

Zuerst das Fehlerlog lesen

Jeder 502 hinterlässt eine Zeile im Fehlerlog von nginx. Unter Debian und Ubuntu ist das /var/log/nginx/error.log, sofern die Konfiguration der Website mit error_log keine andere Datei nennt.

tail -n 50 /var/log/nginx/error.log

Laden Sie die Seite einmal neu, während Sie das Log mit tail -f beobachten. Die neueste Zeile ist die, auf die es ankommt. Was hinter der Fehlernummer steht, sagt Ihnen, wo Sie suchen müssen.

Was die Zeile bedeutet

  • connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory): PHP-FPM läuft nicht, oder nginx zeigt auf den Socket einer PHP-Version, die nicht mehr installiert ist. ls /run/php/ zeigt, welche Sockets es gibt.
  • Dieselbe Zeile mit (13: Permission denied): Eigentümer oder Rechte des Sockets lassen den nginx-Benutzer nicht hinein. Vergleichen Sie listen.owner, listen.group und listen.mode im PHP-FPM-Pool mit dem Benutzer, unter dem nginx läuft.
  • connect() failed (111: Connection refused) while connecting to upstream: Auf der Adresse in proxy_pass oder fastcgi_pass lauscht nichts. Die Anwendung ist abgestürzt oder lauscht auf einem anderen Port.
  • upstream prematurely closed connection while reading response header from upstream: Die Anwendung hat die Anfrage angenommen und ist beim Antworten gestorben oder beendet worden. Ihr eigenes Log, oder dmesg für den OOM-Killer, nennt den Grund.
  • upstream sent too big header while reading response header from upstream: Die Anwendung schickt Header, meist Cookies, die größer sind als der Puffer von nginx. Erhöhen Sie proxy_buffer_size, bei PHP fastcgi_buffer_size, Schritt für Schritt.

Die üblichen Lösungen, der Reihe nach

Setzen Sie statt php8.3-fpm Ihre eigene PHP-Version oder den Namen Ihres Dienstes ein.

  1. systemctl status php8.3-fpm, oder der Dienst Ihrer Anwendung, zeigt, ob er läuft, und seine letzten Logzeilen. systemctl list-units --type=service | grep -i fpm findet den richtigen Namen.
  2. systemctl restart php8.3-fpm holt einen gestoppten Dienst zurück. Stoppt er nach wenigen Minuten wieder, war der Neustart nicht die Lösung: journalctl -u php8.3-fpm -n 100 sagt, warum.
  3. Bei einer Anwendung hinter proxy_pass zeigt ss -tlnp, was auf welchem Port lauscht. curl -I http://127.0.0.1:3000, mit dem Port Ihrer Anwendung, fragt die Anwendung direkt, an nginx vorbei.
  4. Nach jeder Änderung an der nginx-Konfiguration prüft nginx -t sie, und systemctl reload nginx übernimmt sie, ohne Verbindungen abzubrechen.

Was Sie lassen sollten

  • Starten Sie nicht als Erstes den ganzen Server neu. Gingen PHP-FPM die Worker oder der Speicher aus, kommt der 502 wieder, und die Logzeilen, die das gezeigt hätten, sind danach schwerer zu finden.
  • Drehen Sie nicht alle Timeouts und Puffer auf einmal hoch. Ein 502 ist kein Timeout; das wäre ein 504, und der hat eigene Ursachen.
  • Lassen Sie ein PHP-Upgrade nicht halb fertig liegen. Wurde das alte PHP-Paket entfernt, muss die Konfiguration der Website auf den Socket der neuen Version zeigen.

Wann Sie abgeben sollten

Hören Sie auf, wenn der Dienst nach jedem Neustart wieder stirbt, wenn das Log auf Speicher oder einen Absturz zeigt, den Sie nicht erklären können, oder wenn über die Website bezahlt wird und jede Stunde Geld kostet. Unsere Server-Rettung kostet pauschal $69 pro Vorfall, ein Beginn am selben Tag steht mit $109 in der Preisliste. Zuerst laufen rein lesende Prüfungen, kein zerstörender Schritt läuft ohne Backup davor, und können wir es nicht beheben, zahlen Sie nichts.

/ Fragen

Häufige Fragen

Was bedeutet 502 Bad Gateway?
Der Server, der geantwortet hat, meist nginx oder ein CDN, funktioniert, aber die Anwendung oder der Server dahinter hat keine gültige Antwort geschickt. Der Fehler liegt fast immer hinter nginx, nicht in nginx.
Liegt ein 502 an mir oder am Hoster?
Auf Ihrem eigenen VPS meist an PHP-FPM oder an der Anwendung auf diesem Server. Trägt die 502-Seite den Namen eines CDN, hat das CDN von Ihrem Server keine Antwort bekommen; prüfen Sie dann zuerst, ob der Server überhaupt antwortet.
Warum kommt und geht der 502?
Meist gehen PHP-FPM unter Last die Worker aus, oder ein Prozess wird wegen Speichermangels beendet und startet neu. Legen Sie die Zeitstempel im Fehlerlog neben die Zugriffe, dann sehen Sie, was davon.
Was kostet die Behebung eines 502?
Bei uns die Server-Rettung für $69 pro Vorfall, oder $109 mit Beginn am selben Tag. Können wir es nicht beheben, zahlen Sie nichts.
/ Quellen

Woher jede Aussage stammt

Mit den Quellen abgeglichen am .

Weitere Ratgeber