HTTP 504 Gateway Timeout

Ein vorgelagerter Server hat nicht rechtzeitig geantwortet. Der Fehler liegt in der Kette hinter dem Endpunkt, nicht am Endpunkt selbst.

Definiert in RFC 9110 §15.6.5 — 504 Gateway Timeout · MDN-Referenz

Wo Ihnen HTTP 504 in der Praxis begegnet

Ein Gateway oder Load Balancer gibt auf, weil ein Upstream-Server nicht rechtzeitig geantwortet hat – meistens aufgrund einer langsamen Abfrage, eines ausgelasteten Pools oder eines Downstream-Aufrufs ohne eigenes Timeout.

Warum Sie ihn testen sollten

Testen Sie, was passiert, wenn Ihr eigenes Timeout kürzer ist als das des Gateways – Sie erhalten einen clientseitigen Abbruch anstelle des 504-Fehlers, und Ihre Protokolle werden von deren abweichen.

Was Ihr Client bei einem 504 tun sollte

Das Entscheidende an einem 504: Die Arbeit kann noch laufen. Das Gateway hat aufgehört zu warten; der Upstream hat nicht unbedingt aufgehört zu arbeiten. Ein Schreibvorgang nach einem 504 zu wiederholen kann ihn verdoppeln – machen Sie ihn idempotent oder prüfen Sie vor der Wiederholung den Zustand. Setzen Sie einen Client-Timeout unter dem des Gateways, damit Sie die Frist im Griff behalten.

504 und die Codes, mit denen er verwechselt wird

Endpunkte, die 504 zurückgeben

4 Endpunkte dieses Playgrounds antworten mit 504. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

Fragen zu HTTP 504

Ist ein 504-Fehler die Schuld des Clients?
Selten – aber wenn ein Kunde aggressiv versucht, in einem bereits angeschlagenen vorgelagerten Bereich wieder Fuß zu fassen, verschlimmert er die Situation erheblich.
Wurde meine Anfrage bearbeitet?
Ein 504 kann es Ihnen nicht sagen. Diese Mehrdeutigkeit ist der Grund, warum es Idempotency-Keys gibt.

Weitere Server-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert