504 Gateway Timeout: Wenn das Backend zu langsam antwortet
504 Gateway Timeout bedeutet, dass ein Proxy oder Load Balancer innerhalb seiner Wartezeit keine Antwort vom Anwendungsserver erhalten hat. Die Ursache ist fast immer eine zu langsame Verarbeitung, etwa durch lange Datenbankabfragen, externe API-Aufrufe oder Überlastung. Timeouts zu erhöhen verdeckt das Problem nur.
Wo der Timeout entsteht
Jede Schicht hat eigene Wartezeiten: CDN, Load Balancer, Webserver (bei Nginx etwa proxy_read_timeout oder fastcgi_read_timeout, standardmäßig 60 Sekunden) und die Anwendung selbst (bei PHP max_execution_time). Der 504 kommt von der Schicht, deren Geduld zuerst endet.
Häufige Ursachen
- Langsame Datenbankabfragen ohne passenden Index.
- Gesperrte Tabellen durch lange Schreibvorgänge oder Importe.
- Externe Dienste (Zahlung, Versand, Schnittstellen), die nicht antworten.
- Rechenintensive Aufgaben im Web-Request statt im Hintergrund.
- Überlastung, bei der Anfragen in der Warteschlange stehen.
Vorgehen
- Betroffene Adresse und Uhrzeit aus dem Monitoring ablesen.
- Im Fehlerlog des Webservers nach „upstream timed out“ suchen.
- Slow-Query-Log der Datenbank prüfen.
- Aufrufe externer Dienste mit eigenen, kurzen Timeouts absichern.
- Lange Aufgaben in Hintergrundjobs verschieben und diese per Heartbeat überwachen.
Timeouts sinnvoll setzen
Ein höherer Timeout lässt den Fehler verschwinden, aber Besucher warten trotzdem. Besser: Timeouts von außen nach innen abstufen (CDN länger als Proxy, Proxy länger als Anwendung), damit die Anwendung selbst einen verständlichen Fehler liefern kann. Für das Monitoring empfiehlt sich ein eigener Timeout, etwa 30 Sekunden, und zusätzlich der Blick auf den Antwortzeit-Verlauf.
Häufige Fragen
Hilft es, den Timeout zu erhöhen?
Nur kurzfristig. Die Ursache, eine zu langsame Verarbeitung, bleibt bestehen und Besucher warten weiterhin lange.
Was ist der Standard-Timeout bei Nginx?
proxy_read_timeout und fastcgi_read_timeout betragen standardmäßig 60 Sekunden.
Wie erkenne ich 504-Fehler früh?
Ein steigender Verlauf der Antwortzeit kündigt Timeouts oft an. Monitoring mit Antwortzeit-Historie macht das sichtbar.
Prüfungen ab jeder Minute, Alarm per E-Mail, SMS, WhatsApp oder Webhook. 5 Monitore kostenlos.
FlixGuard