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
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.