Ratgeber

HTTP 502: Bad Gateway verstehen und beheben

Der Browser erreicht oft den Proxy, während der Ursprungsserver nicht rechtzeitig oder ungültig antwortet.

Was ist ein Gateway?

Moderne Websites bestehen oft aus mehreren Serverebenen. Ein CDN, Reverse Proxy, Load Balancer oder API-Gateway steht vor der eigentlichen Anwendung. Erhält dieser Vermittler keine brauchbare Antwort vom Ursprung, kann er 502 an Besucher zurückgeben. Häufig liegt der Fehler zwischen zwei Servern, nicht zwischen Browser und Internetzugang.

Was können Besucher tun?

  1. Laden Sie die Seite einmal neu und versuchen Sie es nach kurzer Zeit erneut. Ein kurzer Ausfall zwischen Diensten ist eine mögliche Ursache.
  2. Prüfen Sie andere Websites. Laufen sie normal, ist Ihre Verbindung vermutlich nicht allgemein gestört.
  3. Sehen Sie nach einer offiziellen Statusseite und bekannten Störungen.
  4. Ein anderes Netzwerk oder privates Fenster kann VPN-, Proxy- oder Cache-Probleme eingrenzen, löst aber nicht jeden 502-Fehler.

Unterschied zwischen 502 und ähnlichen Fehlern

502 bedeutet, dass ein Vermittler vom vorgelagerten Server eine ungültige Antwort erhält. 503 bezeichnet meist eine vorübergehend nicht verfügbare Anwendung, etwa wegen Wartung oder Überlastung. 504 bedeutet, dass das Gateway nicht rechtzeitig eine Antwort bekommen hat. Die Ursachen können sich überschneiden, aber die Codes helfen bei der ersten Eingrenzung.

Was sollte der Betreiber prüfen?

  1. Ursprung: laufen Anwendung und Webserver auf dem erwarteten Port?
  2. Proxy zum Ursprung: erlauben Firewall und Netzwerkregeln die Verbindung?
  3. TLS: stimmen Domainname, Zertifikat und Protokoll bei HTTPS zwischen den Ebenen überein?
  4. Kapazität: sind Worker, Verbindungen oder Speicher erschöpft, oder dauert die Antwort zu lange?
  5. Letzte Änderung: begann der Fehler nach Deployment, DNS-, Zertifikats- oder Proxy-Änderungen?
  6. Protokolle: vergleichen Sie CDN/Proxy und Ursprung gemeinsam.

Beispiel eines Anfragewegs

Ein Besucher öffnet example.com. Das CDN nimmt die Anfrage an und leitet sie zum Ursprung weiter. Lauscht der Prozess nicht mehr auf Port 443 oder liefert eine ungültige TLS-Verbindung, kann das CDN 502 anzeigen, obwohl es selbst erreichbar ist.

Was ist kein sinnvoller erster Schritt?

Alle Cookies zu löschen, DNS-Resolver zu wechseln oder den Browser neu zu installieren hilft meist nicht bei einem 502 zwischen Servern. Solche Schritte sind nur bei konkreten Hinweisen auf lokale Proxys, VPNs oder falsche DNS-Routen sinnvoll.

Häufige Fragen

Ist 502 immer nur vorübergehend?

Nein. Auch eine fehlerhafte Konfiguration kann einen dauerhaften 502 verursachen.

Hilft es, den Cache zu leeren?

Normalerweise nicht, wenn der Fehler zwischen Proxy und Ursprung entsteht.

Kann ein CDN 502 zurückgeben?

Ja, wenn es keine gültige Antwort vom Ursprungsserver erhält.

Können Zertifikatsprobleme 502 auslösen?

Ja, falls die TLS-Verbindung zwischen Proxy und Ursprung scheitert.