FlixGuard
Fehlercodes

502 Bad Gateway: Ursachen und Lösung

Kurz gesagt

502 Bad Gateway bedeutet: Ein vorgeschalteter Server (Proxy, Load Balancer, CDN) hat vom eigentlichen Anwendungsserver keine gültige Antwort erhalten. Häufigste Ursachen sind ein abgestürzter oder neu startender Anwendungsprozess, falsche Socket- oder Port-Angaben, zu wenige Worker und zu kleine Puffer.

Wie ein 502 entsteht

Viele Websites bestehen aus zwei Schichten: einem Webserver oder Proxy (etwa Nginx, Apache, ein CDN) und dahinter der Anwendung (etwa PHP-FPM, Node.js, Python). Der Proxy leitet jede Anfrage weiter. Kommt keine oder eine unbrauchbare Antwort zurück, meldet er 502.

Häufige Ursachen

  • Anwendung läuft nicht: PHP-FPM oder der Node-Prozess ist abgestürzt oder wird gerade neu gestartet.
  • Falsche Verbindung: Socket-Pfad oder Port in der Proxy-Konfiguration passt nicht zur Anwendung, etwa nach einem PHP-Update.
  • Rechte am Socket: Der Webserver-Benutzer darf den Unix-Socket nicht öffnen.
  • Zu wenige Worker: Alle Prozesse sind belegt, neue Verbindungen werden abgewiesen.
  • Prozess wird beendet: etwa durch den OOM-Killer bei Speichermangel.
  • Zu kleine Header-Puffer: große Cookies oder Header überschreiten die Puffer des Proxys.

Schritt für Schritt prüfen

# Läuft die Anwendung?systemctl status php8.3-fpm # Was sagt der Proxy?tail -n 50 /var/log/nginx/error.log # Wurde ein Prozess wegen Speichermangel beendet?journalctl -k --since "1 hour ago" | grep -i "out of memory"

Typische Meldungen im Nginx-Log sind „connect() failed (111: Connection refused)“ (Anwendung läuft nicht oder falscher Port), „No such file or directory“ beim Socket (falscher Pfad) und „upstream sent too big header“ (Puffer zu klein).

Lösungen

  • Anwendung neu starten und Ursache des Absturzes im Log suchen.
  • Socket-Pfad bzw. Port in Proxy und Anwendung abgleichen.
  • Bei PHP-FPM pm.max_children an den verfügbaren Speicher anpassen.
  • Bei Header-Fehlern fastcgi_buffers bzw. proxy_buffer_size erhöhen.
  • Bei Deployments Prozesse nacheinander statt gleichzeitig neu starten.

Kurze 502-Spitzen

Treten 502 nur für Sekunden auf, etwa bei jedem Deployment, sind sie leicht zu übersehen. Ein Monitoring im Minutentakt mit Verlauf zeigt solche Muster. Abhilfe schaffen Reloads statt Restarts oder ein Zero-Downtime-Deployment.

Häufige Fragen

Liegt ein 502-Fehler an meinem Browser?

Nein. 502 entsteht auf dem Server zwischen Proxy und Anwendung. Neu laden hilft nur, wenn das Problem zufällig vorbei ist.

Was ist der Unterschied zwischen 502 und 504?

Bei 502 erhält der Proxy eine ungültige oder gar keine Antwort. Bei 504 wartet er zu lange auf eine Antwort.

Kann ein CDN einen 502 verursachen?

Ja, wenn das CDN den Ursprungsserver nicht erreicht oder dieser ungültig antwortet. Die Ursache liegt dann meist am Ursprungsserver.

Website-Monitoring mit FlixGuard

Prüfungen ab jeder Minute, Alarm per E-Mail, SMS, WhatsApp oder Webhook. 5 Monitore kostenlos.

Ab heute merken Sie es zuerst.

Der erste Monitor läuft in zwei Minuten. Der Starter-Tarif bleibt kostenlos, ohne Kreditkarte.

Drei Kolleginnen und Kollegen lachen gemeinsam am Laptop