Drei Antworten, drei unterschiedliche Hinweise
Alle drei Codes sind HTTP-Antworten einer erreichten Instanz. Der sichtbare Server kann ein CDN, Proxy oder Load Balancer sein. Der Code allein benennt weder die betroffene Maschine noch die genaue Ursache. Prüfe deshalb Antwort und Infrastruktur gemeinsam.
| Code | Aussage | Erster Betreiberblick |
|---|---|---|
| 502 | Keine gültige Upstream-Antwort | Proxy-Fehlerlog, Zielport, Backend-Prozess |
| 503 | Dienst vorübergehend nicht verfügbar | Wartung, Kapazität, Health-Checks |
| 504 | Upstream antwortet nicht rechtzeitig | Request-Dauer, Abhängigkeiten, Timeout-Kette |
Bei 502 die Verbindung zum Backend prüfen
Suche nach abgelehnten Verbindungen, vorzeitigen Abbrüchen oder ungültigen Headern. Bei PHP-FPM können ein veralteter Socket-Pfad oder ein abgestürzter Prozess relevant sein. Prüfe Protokoll und Erreichbarkeit aus der tatsächlichen Proxy-Umgebung.
Ein höheres Timeout repariert weder einen falschen Port noch fehlende Socket-Rechte. Korrigiere zuerst den konkreten Befund.
Bei 503 Verfügbarkeit und Kapazität prüfen
Suche nach geplanten Wartungszuständen, vollen Queues und gescheiterten Health-Checks. Eine Überlastung kann von langsamen Abhängigkeiten ausgehen, obwohl CPU-Auslastung unauffällig ist. Prüfe auch Worker und Verbindungspools.
Besucher sollten Retry-After beachten. Wiederholungen ohne Pause können zusätzliche Last erzeugen und die Erholung verzögern.
Bei 504 die Zeit aufschlüsseln
Vergleiche Proxy-Log und Anwendungstrace. Wartet der Request auf einen Worker, eine Datenbanksperre oder eine externe API? Das erste ablaufende Limit in der Kette bestimmt oft den sichtbaren Fehler.
Verlagere lange Aufgaben gegebenenfalls in Hintergrundjobs mit Statusabfrage. Eine Bestellung kann nach dem Gateway-Timeout noch fertig werden; idempotente Verarbeitung und klare Statusabfragen verhindern doppelte Vorgänge.
Was Besucher und Checker daraus ableiten können
Teste nach einer Pause eine normale Seite und prüfe bei schreibenden Aktionen zuerst deren Ergebnis. Melde URL, Zeitpunkt und Request-ID an den Betreiber. Ein öffentlicher Check kann die aktuelle Antwort vergleichen, aber keine privaten Backend-Logs lesen.
Proxy-Produkte können ähnliche Transportprobleme unterschiedlich abbilden. Verwende den Code als Richtung für die Diagnose, nicht als endgültigen Ursachenbeweis. Ein einzelner Standort beweist keine weltweite Störung.
Häufige Fragen
Welcher Fehler ist am schlimmsten?
Die Auswirkung hängt von Umfang und Dauer ab, nicht von der höheren Zahl. Ein einzelner 504 kann weniger relevant sein als ein dauerhafter 503 für alle Nutzer.
Kann derselbe Vorfall mehrere Codes erzeugen?
Ja. Ein überlastetes Backend kann zunächst langsam antworten, später abbrechen und schließlich aus dem Pool genommen werden.
Sind Browser-Timeouts auch 504?
Nein. 504 ist eine HTTP-Antwort eines Gateways; eine Browsermeldung kann schon vorher beim Verbindungsaufbau entstehen.