Diese Seite hilft bei der technischen Eingrenzung. Wenn die Website oder der Server produktiv ausgefallen ist, kann ICFOX die Diagnose remote übernehmen.
Nginx 502 Bad Gateway
Ein 502 Bad Gateway bedeutet meist: Nginx ist erreichbar, bekommt aber vom Upstream keine gültige Antwort. Die Ursache liegt häufig hinter Nginx.
Was der Fehler technisch bedeutet
Bei Reverse-Proxy-Setups spricht Nginx mit einem Upstream wie PHP-FPM, Gunicorn, Node.js, einem Docker-Container oder einem anderen HTTP-Dienst. Wenn dieser Prozess nicht läuft, am falschen Port lauscht, der Socket fehlt oder die Verbindung vorzeitig abbricht, liefert Nginx 502. Der Nginx error log nennt oft bereits den betroffenen Upstream.
Häufige Ursachen
-
Upstream-Prozess down
PHP-FPM, Gunicorn, Node.js oder ein anderer Backend-Dienst läuft nicht oder startet sofort wieder neu.
-
Falscher Socket oder Port
Nginx zeigt auf einen Pfad/Port, an dem der Upstream nicht mehr lauscht.
-
Docker-Netzwerk oder DNS
Containername, Netzwerk, Port-Mapping oder Service-Discovery stimmen nach Deployment nicht mehr.
-
Timeout oder Verbindungsabbruch
Backend crasht, wird vom OOM-Killer beendet oder beendet die Verbindung ohne gültige Antwort.
Sinnvolle Prüfung in dieser Reihenfolge
-
1. Nginx error log lesen
Meldungen wie connect() failed, no such file, connection refused oder upstream prematurely closed connection beachten.
-
2. Upstream lokal testen
Port oder Unix-Socket direkt prüfen und Prozess-/systemd-Status kontrollieren.
-
3. Deployment und Konfiguration vergleichen
Änderungen an Nginx, PHP-FPM, Docker Compose, Umgebungsvariablen und Ports abgleichen.
-
4. Ressourcen und Restart-Loops prüfen
RAM, Disk, OOM-Ereignisse, Container-Exitcode und Service-Journal kontrollieren.
Was Sie jetzt besser nicht tun
Nginx neu zu starten behebt einen ausgefallenen Upstream selten dauerhaft. Nicht wahllos Timeouts erhöhen: Wenn das Backend crasht oder festhängt, verschiebt ein höherer Timeout nur das Symptom.
Verwandte Fehler und direkte Hilfe
Wenn die Ursache nicht schnell eindeutig wird, führen die folgenden Seiten zur passenden Soforthilfe oder zu einem eng verwandten Fehlerbild.
Häufige Fragen
Ist Nginx bei einem 502 immer kaputt?
Nein. Nginx funktioniert oft korrekt und meldet lediglich, dass der konfigurierte Upstream nicht erreichbar oder ungültig antwortet.
Kann Docker einen 502 verursachen?
Ja. Ein gestoppter Container, falscher Port, fehlendes Netzwerk oder ein geänderter Servicename sind typische Ursachen.
Was ist der Unterschied zwischen 502 und 503?
502 weist häufig auf eine fehlerhafte oder abgebrochene Upstream-Kommunikation hin; 503 kann zusätzlich bewusst von Anwendung oder Proxy bei Nichtverfügbarkeit ausgegeben werden.