502 Bad Gateway: Bedeutung und Lösung des Fehlers

502 Bad Gateway bedeutet, dass ein Server, der als Gateway oder Proxy arbeitet, eine ungültige Antwort von dem Server hinter sich erhalten hat. Der Fehler liegt also zwischen zwei Servern und kommt nicht vom Browser oder Gerät des Besuchers. [1] [2]

Dieser Ratgeber erklärt die Bedeutung von 502 Bad Gateway in zwei Teilen. Als Besucher finden Sie im kurzen Abschnitt unten, was Sie versuchen können. Betreiben Sie die Website selbst, zeigt Ihnen der Abschnitt zur Behebung, welche Station den Fehler zurückgibt, wie Sie die Zeile im Protokoll lesen, die die Ursache nennt, und wie Sie den Fehler beheben und künftig verhindern.

Was bedeutet 502 Bad Gateway?

Eine Anfrage an eine Website durchläuft oft mehrere Stationen:

Browser → CDN oder Proxy → Webserver → Anwendung

Jede Station leitet die Anfrage an die nächste weiter. Liefert die Station hinter einem Proxy eine Antwort, die der Proxy nicht verwenden kann, gibt der Proxy 502 zurück. Der Statuscode sagt nicht, welche Station ausgefallen ist. In nginx erscheint 502 auch dann, wenn der Upstream die Verbindung ablehnt, zurücksetzt oder früh schließt. Der Code zeigt also nur, dass die Verbindung hinter dem Proxy unterbrochen ist.

Ein 502 bedeutet dabei weder, dass der Besucher eine fehlerhafte Anfrage gesendet hat, noch ist er ein Timeout. Ein langsamer Upstream liefert einen anderen Code, der im nächsten Abschnitt behandelt wird.

502 vs. 503 vs. 504

Drei Codes decken die meisten serverseitigen Fehler zwischen den Stationen ab. Sie haben unterschiedliche Ursachen, deshalb sollten Sie den Code lesen, bevor Sie mit der Fehlersuche beginnen.

Ein 504 ist ein Zeitproblem. Der Upstream hat zu spät geantwortet, nicht falsch. In nginx betragen die Standard-Lesetimeouts für Proxy und FastCGI 60 Sekunden [4] [5].

Wenn Sie als Besucher einen 502-Fehler sehen

Den Server können Sie als Besucher nicht reparieren, aber Sie können Ihre eigene Verbindung ausschließen und den Fehler melden.

• Warten Sie eine Minute und laden Sie die Seite neu. Ein Neustart oder eine Bereitstellung auf dem Server kann den Fehler von selbst beenden.
• Probieren Sie einen anderen Browser oder ein anderes Netzwerk, etwa mobile Daten. Lädt die Seite dort, liegt das Problem in Ihrer Verbindung.
• Prüfen Sie die Statusseite der Website, falls es eine gibt.
• Notieren Sie die Uhrzeit und die genaue Adresse, die Sie geöffnet haben. Der Betreiber braucht beides, um die passende Zeile im Protokoll zu finden.

Meist liegt die Ursache auf dem Server, deshalb kann nur der Betreiber den Fehler beheben. Wenn Ihnen die Website gehört, folgen Sie den Schritten unten.

502 Bad Gateway auf Ihrem Server beheben

Arbeiten Sie von außen nach innen. Jeder Schritt schließt eine Station aus, bevor Sie zur nächsten übergehen.

curl -I "https://www.example.com/"
curl -I --resolve www.example.com:443:203.0.113.10 "https://www.example.com/"

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

sudo systemctl status php8.3-fpm
sudo ss -lxp | grep php

pm2 status
sudo ss -ltnp | grep 3000

sudo systemctl status gunicorn
sudo ss -ltnp | grep 8000

location / {
    proxy_pass http://127.0.0.1:3000;
}

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

sudo nginx -t && sudo systemctl reload nginx

sudo dmesg -T | grep -i -E "out of memory|killed process"
free -h

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_buffer_size 16k;
    proxy_buffers 8 16k;
}

sudo ufw status verbose

502 hinter Cloudflare oder Citadel

Der Inhalt der Fehlerseite zeigt, welche Seite den Fehler erzeugt hat. Cloudflare gibt an, dass eine 502- oder 504-Seite mit Cloudflare-Branding vom Origin-Webserver stammt. Eine einfache Seite ohne Cloudflare-Branding kann von Cloudflare stammen. Cloudflare nennt aber auch eine fehlerhafte Komprimierung am Origin als Ursache für 502-Fehler ohne Branding. [7] Das Branding klärt also die meisten Fälle, aber nicht alle. Ist die Seite ohne Branding und antwortet der Origin direkt mit 200, prüfen Sie die Komprimierungseinstellungen des Origins.

Citadel ist das eigenständige Layer-7-Schutzprodukt von StealthRDP für HTTP/HTTPS. Es benötigt keinen StealthRDP-VPS und sitzt wie ein Proxy vor Ihrem Origin. Ein 502 für Besucher kann daher bedeuten, dass Citadel den Origin nicht erreicht. Prüfen Sie die Origin-Probes auf der Seite „Health“ von Citadel und die Origin-Einstellungen auf der Seite „Origin“ von Citadel.

Schadet ein 502-Fehler der SEO?

Ein kurzer 502-Fehler richtet wenig Schaden an. Die Crawler-Dokumentation von Google besagt, dass 5xx- und 429-Antworten die Crawler verlangsamen. URLs, die dauerhaft Serverfehler liefern, werden irgendwann aus dem Index entfernt, obwohl bereits indexierte URLs zunächst erhalten bleiben. Das Crawling beschleunigt sich wieder, sobald der Server 2xx-Antworten liefert. [8]

Praktisch heißt das: Beheben Sie die Ursache schnell. Ein Fehler, der lange anhält, kann Rankings kosten.

502-Fehlern vorbeugen

• Überwachen Sie die Website von außen. Eine externe Prüfung meldet den Beginn des Fehlers, statt dass ihn ein Besucher später meldet. Siehe Tools zur Uptime-Überwachung.
• Halten Sie genug Arbeitsspeicher bereit. Out-of-Memory-Abbrüche verursachen die Zeilen „prematurely closed connection“. Geht der Speicher regelmäßig aus, lesen Sie Anzeichen, dass Sie die Ressourcen Ihres VPS aufrüsten sollten und häufige VPS-Hosting-Probleme und ihre Lösungen.
• Starten Sie die Anwendung bei einem Fehler neu. Eine systemd-Unit mit Neustart-Richtlinie bringt die Anwendung nach einem Absturz zurück. Restart=on-failure startet den Prozess nur neu, wenn er mit einem Fehler beendet wurde. Der Fehler, der den Absturz verursacht hat, wird dadurch nicht behoben. Bewahren Sie deshalb die Protokollzeilen aus Schritt 2 auf.

[Service]
ExecStart=/usr/bin/node /srv/myapp/server.js
Restart=on-failure
RestartSec=5

• Richten Sie eine Health-Prüfung ein. Geben Sie der Anwendung einen Endpunkt, der nur dann 200 zurückgibt, wenn sie Anfragen beantworten kann, und überwachen Sie diesen Endpunkt. Ein Prozess, der läuft, aber hängt, fällt dann als Fehler auf.
• Klären Sie vorab, wo Sie suchen, wenn der Server stehen bleibt. Wenn der Server von allein nicht mehr antwortet, lesen Sie warum ein Server zufällig stoppt.

Die Behebung selbst auf einem StealthRDP-VPS durchführen

Linux-Tarife von StealthRDP enthalten vollen Root-Zugriff. Sie betreiben den Webserver und die Anwendung selbst und können jeden Schritt dieses Ratgebers auf Ihrem Server ausführen. Tarife vergleichen Sie auf Linux-VPS und VPS-Tarife.