Bedeutung
Ein Gateway oder Proxy hat vom Upstream-Server, an den er die Anfrage weitergeleitet hat, eine ungültige Antwort erhalten.
Typische Ursachen
- Der App-Server ist abgestürzt oder lauscht nicht (falscher Port oder Socket)
- Upstream hat die Verbindung geschlossen oder fehlerhafte Header gesendet
- Neustart von PHP-FPM-, Gunicorn- oder Node-Prozessen
So beheben Sie es
Als Client oder Besucher
Kurz warten und erneut versuchen; meist ist es vorübergehend. Bleibt es bestehen, ist das Backend der Website ausgefallen.
Als Betreiber der Website oder API
Prüfen, ob der Upstream-Prozess läuft und auf der Adresse lauscht, die der Proxy nutzt, und im Fehlerlog des Proxys den genauen Upstream-Fehler lesen.
Beispielantwort
HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0Spezifikation
FAQ
› Wie behebe ich 502 Bad Gateway in nginx?
Upstream prüfen (läuft die App, stimmt die proxy_pass-Adresse bzw. der Socket) und das nginx-Fehlerlog lesen; den App-Server neu starten, falls er abgestürzt ist.
› 502 oder 504?
502: Upstream hat Unsinn geantwortet oder die Verbindung geschlossen. 504: Upstream hat nicht rechtzeitig geantwortet.