504 Gateway Timeout oznacza, że serwer działający jako brama lub proxy nie otrzymał na czas odpowiedzi od serwera nadrzędnego, której potrzebował do zrealizowania żądania. Proxy czekało przez skonfigurowany limit czasu i zrezygnowało.
W odróżnieniu od 502 serwer nadrzędny nie wysłał uszkodzonej odpowiedzi; nie wysłał na czas niczego. Typowe przyczyny to wolne zapytania do bazy danych, długo generowane raporty, zawieszające się zewnętrzne API i przeciążone backendy. Każda warstwa ma własny limit, np. proxy_read_timeout w nginx (domyślnie 60 sekund), limity bezczynności w load balancerach i limity czasu funkcji serverless.
Za Cloudflare serwer źródłowy, który przyjmuje połączenie, ale odpowiada zbyt wolno, powoduje błąd 524 A Timeout Occurred, a nie 504.
Przykładowa odpowiedź
HTTP/1.1 504 Gateway Timeout
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: text/html
Content-Length: 106
<html><body><h1>504 Gateway Timeout</h1>
<p>The upstream server did not respond in time.</p></body></html>SEO i sprawdzanie przekierowań
Błędy 504 liczą się jako błędy serwera: spowalniają indeksowanie, a jeśli się utrzymują, prowadzą do wyindeksowania. Wolne odpowiedzi zmniejszają też liczbę stron, które Google indeksuje. Narzędzie Pomiar opóźnień przekierowań pokazuje czas każdego przeskoku, co pomaga znaleźć wolne przekierowania lub wolną stronę docelową, zanim zaczną przekraczać limity czasu.
Typowe przyczyny i zastosowania
- Wolne zapytania do bazy danych lub długotrwałe żądania przekraczają limit czasu proxy.
- Zewnętrzne API, od którego zależy aplikacja, nie odpowiada.
- Serwer nadrzędny jest przeciążony albo proxy nie może się z nim połączyć z powodu problemów z DNS lub siecią między nimi.
- Limity czasu w poszczególnych warstwach są niespójne, więc proxy rezygnuje, zanim aplikacja skończy pracę.