Was bedeutet HTTP 502?
Ein Gateway oder Reverse Proxy konnte die Anfrage nicht mit einer gültigen Antwort vom nachgelagerten Dienst abschließen. Der Proxy selbst antwortet also noch. Daraus folgt weder ein kompletter Host-Ausfall noch automatisch ein Fehler im Browser.
Als Besucher sinnvoll reagieren
Warte kurz und versuche einen normalen Seitenaufruf erneut. Prüfe vor dem erneuten Absenden von Bestellungen oder Zahlungen deren Zustand. Wenn nur eine Website betroffen ist, wird ein Router-Reset das Backend dieser Website nicht reparieren.
Vergleiche bei einem länger anhaltenden Problem WLAN und Mobilfunk. Unterschiedliche Ergebnisse können auf CDN-Routen oder regionale Unterschiede hinweisen. Notiere URL, Zeit und eine sichtbare Fehler-ID für den Betreiber.
Betreiber: Proxy und Upstream vergleichen
Prüfe im Proxy-Error-Log, ob Verbindungsablehnung, vorzeitiger Verbindungsabbruch, ungültige Header oder eine TLS-Prüfung genannt werden. Kontrolliere Zielhost, Port, Protokoll und Namensauflösung aus der Umgebung des Proxys.
Ein gesunder Prozess auf dem Host reicht nicht: Der Dienst muss auf der erwarteten Adresse lauschen und aus dem Container oder Netzwerk des Proxys erreichbar sein. Teste den freigegebenen Health-Endpunkt gezielt und bewahre Host-Header und TLS-Servernamen bei.
nginx und PHP-FPM
Bei FastCGI prüfe, ob der konfigurierte Socket existiert und nginx ihn verwenden darf. Nach einem PHP-Versionswechsel kann der Socket-Pfad veraltet sein. Vergleiche PHP-FPM-Pool-Konfiguration, Dienstzustand und Logs auf Abstürze oder erschöpfte Worker.
In WordPress können lange Plugin-Aufrufe den Pool binden oder PHP-Prozesse beenden. Erhöhe Worker-Zahlen nur innerhalb des verfügbaren Speichers und untersuche langsame Requests. Ein pauschaler Neustart kann Symptome kurz verdecken, ohne die Ursache zu beheben.
502, 503 und 504 auseinanderhalten
502 steht für eine fehlgeschlagene gültige Antwort vom Upstream. 503 bedeutet vorübergehende Nichtverfügbarkeit; 504 eine überschrittene Wartezeit des Gateways. Konkrete Proxy-Produkte ordnen einzelne Transportfehler unterschiedlich zu. Entscheidend bleibt der zugehörige Logeintrag.
Häufige Fragen
Liegt 502 immer an nginx?
Nein. Auch CDNs, Load Balancer und andere Reverse Proxys können 502 senden.
Soll ich Proxy-Timeouts erhöhen?
Nicht ohne Diagnose. Bei falschem Socket, TLS-Fehler oder abgestürztem Dienst hilft längeres Warten nicht.
Warum sieht mein Browser 502, der Check aber 200?
Messzeit, Netzwerkroute, URL, Cookies oder CDN-Knoten können unterschiedlich sein. Vergleiche dieselbe URL möglichst zeitnah.