DevToolPal
DE
5xx Server-Fehler

504 Gateway Timeout

Gateway-Zeitüberschreitung

Bedeutung

Ein Gateway oder Proxy hat vom Upstream-Server nicht rechtzeitig eine Antwort erhalten.

Typische Ursachen

  • Langsame Datenbankabfragen oder externe API-Aufrufe
  • Proxy-Timeout kürzer als die Verarbeitungszeit
  • Upstream-Server wegen Netzproblemen nicht erreichbar

So beheben Sie es

Als Client oder Besucher

Später erneut versuchen; bei langen Vorgängen nachfragen, ob die API asynchrone Verarbeitung anbietet.

Als Betreiber der Website oder API

Den langsamen Pfad beschleunigen oder in einen Hintergrundjob verlagern; Proxy-Timeouts (proxy_read_timeout) nur auf realistische Werte erhöhen.

Beispielantwort

HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0

Spezifikation

RFC 9110 §15.6.5

FAQ

› Wie behebe ich 504 Gateway Timeout in nginx?

Herausfinden, warum der Upstream langsam ist; sind lange Anfragen zu erwarten, proxy_read_timeout und den Timeout des App-Servers gemeinsam erhöhen.

› Wer liefert 504, meine App oder der Proxy?

Der Proxy, Load Balancer oder das CDN vor Ihrer App, nachdem er zu lange auf sie gewartet hat.