意味
ゲートウェイまたはプロキシが上流サーバーから時間内にレスポンスを受け取れませんでした。
よくある原因
- 遅いデータベースクエリや外部 API 呼び出し
- プロキシのタイムアウトが処理時間より短い
- ネットワーク障害で上流サーバーに到達できない
対処法
クライアント・閲覧者の場合
後で再試行します。長い処理なら、API に非同期処理があるか確認します。
サイトや API の運営者の場合
遅い処理を高速化するかバックグラウンドジョブに移し、プロキシのタイムアウト（proxy_read_timeout）は現実的な値までにとどめます。
レスポンス例
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0仕様
よくある質問
› nginx の 504 Gateway Timeout を直すには？
上流が遅い原因を突き止めます。長いリクエストが想定どおりなら、proxy_read_timeout とアプリサーバーのタイムアウトを一緒に上げます。
› 504 を返すのはアプリ？プロキシ？
アプリの前にあるプロキシ、ロードバランサー、CDN が、待ちきれなくなって返します。