Nginx 502 Bad Gateway mit Node.js: Systematische Ursachenanalyse & Notfall-Behebung
Wenn der Reverse-Proxy abstürzt: Sockets, Port-Konflikte, OOM-Kills und Systemd-Wiederbelebung
Kernzusammenfassung
Der Fehler 502 Bad Gateway ist der häufigste Notfall bei modernen Webanwendungen. Er bedeutet schlicht: Der Nginx Reverse-Proxy läuft, aber das dahinterliegende Backend (Node.js, Next.js, Python, PHP) antwortet nicht.
1. Was bedeutet 502 Bad Gateway technisch?
Nginx agiert als Frontend-Reverse-Proxy und leitet eingehende HTTPS-Anfragen an einen internen Port (z. B. `127.0.0.1:3000`) oder einen Unix-Domain-Socket weiter. Erhält Nginx keine gültige Antwort vom Upstream-Prozess, bricht die Verbindung mit HTTP-Status 502 ab.
Die häufigste Ursache ist nicht Nginx selbst, sondern ein abgestürzter Backend-Prozess, ein Speicherüberlauf (Out-of-Memory / OOM-Killer) oder eine Endlosschleife.
2. Der 3-Schritte-Notfall-Check
Mit folgenden Shell-Befehlen isolierst du die Ursache in unter zwei Minuten:
- 1. Nginx Error-Log prüfen: tail -n 50 /var/log/nginx/error.log (Zeigt z. B. "Connection refused" oder "no live upstreams").
- 2. Backend-Dienststatus abfragen: systemctl status dein-dienst.service (Prüft ob der Prozess läuft oder in einer Crash-Loop hängt).
- 3. Port-Belegung verifizieren: ss -tulpn | grep 3000 (Ist der Port aktiv gebunden?).
Wurde der Prozess ohne Fehlermeldung beendet? Führe `dmesg -T | grep -i oom` aus. Hat der Linux-Kernel den Prozess wegen RAM-Mangels gekillt, hilft ein Swapfile oder Prozess-RAM-Limit.
Server-Absturz? Wir helfen sofort!
NYEO bietet schnelle Notfall-Entstörung bei Server-Ausfällen, 502 Bad Gateway Fehlern und Nginx-Konfigurationsproblemen.
Über den Autor: Nico Eichhorn
Inhaber von NYEO Digital in Papenburg. Spezialisiert auf robuste Fullstack-Webanwendungen (Next.js, React, TypeScript), Linux-Serverarchitekturen und Entwickler der SaaS-Plattform Caleb für rechtssichere Arbeitszeiterfassung und Schichtplanung.
Rechtlicher Hinweis: Die in diesem Magazin veröffentlichten Fachbeiträge dienen der allgemeinen Information über gesetzliche Rahmenbedingungen und Best Practices zur Arbeitsorganisation, IT-Sicherheit und Rechnungsstellung. Sie stellen keine Rechts- oder Steuerberatung dar und können eine individuelle Beratung durch einen zugelassenen Rechtsanwalt oder Steuerberater im konkreten Einzelfall nicht ersetzen.