FlixGuard
Fehlercodes

504 Gateway Timeout: Wenn das Backend zu langsam antwortet

Kurz gesagt

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

  1. Betroffene Adresse und Uhrzeit aus dem Monitoring ablesen.
  2. Im Fehlerlog des Webservers nach „upstream timed out“ suchen.
  3. Slow-Query-Log der Datenbank prüfen.
  4. Aufrufe externer Dienste mit eigenen, kurzen Timeouts absichern.
  5. 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.

Website-Monitoring mit FlixGuard

Prüfungen ab jeder Minute, Alarm per E-Mail, SMS, WhatsApp oder Webhook. 5 Monitore kostenlos.

Ab heute merken Sie es zuerst.

Der erste Monitor läuft in zwei Minuten. Der Starter-Tarif bleibt kostenlos, ohne Kreditkarte.

Drei Kolleginnen und Kollegen lachen gemeinsam am Laptop