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
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.
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.
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.
4 Endpunkte dieses Playgrounds antworten mit 504. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.
GET https://funapi.dev/api/protocol/v1/gateway-timeout — Slow upstream — waits ~3s, then 504 (Protocol Lab API) Diesen Endpunkt öffnen und ausführenGET https://funapi.dev/api/faults/v1/status/{code} — Return any status code on demand (200–599) (Fault Injection API) Diesen Endpunkt öffnen und ausführenGET https://funapi.dev/api/weather/v1/current — Current conditions (deterministic per location and hour) (Weather API) Diesen Endpunkt öffnen und ausführenGET https://funapi.dev/api/weather/v1/forecast — Daily forecast, 1–7 days (Weather API) Diesen Endpunkt öffnen und ausführenAlle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung
Zuletzt aktualisiert