HTTP 504 Gateway Timeout とは?

HTTP 504 Gateway Timeout の解説と、CI/CD やデプロイで見かけたときの意味。

HTTP 504 は、gateway や proxy が upstream サーバーからタイムリーな応答を得られなかったことを意味します。

意味するところ

504 は一時的でネットワークに関係します。load balancer や reverse proxy が backend を待ってタイムアウトしました。多くはリトライで解消します。

CI/CD で見かけるとき

CI のデプロイチェックや API 呼び出しは、backend が遅いかスケール中のときに 504 になります。backoff を伴ってリトライしてください。継続する 504 は、tuning が必要な遅い upstream を示します。

重要なポイント

• 504 は upstream のタイムアウトを意味する。
• 通常は一時的なもの。
• backoff を伴ってリトライ。継続する 504 は tuning が必要。

関連ガイド