エラー 502 または 504

エラー 502 bad gateway またはエラー 504 gateway timeout

HTTP 502 または 504 エラーは、Cloudflare がオリジン Web サーバーと接続できないことを示します。

よくある原因

原因は次の 2 つが考えられます。

オリジン Web サーバーからの 502/504 エラー（最も多いケース）。
Cloudflare からの 502/504 エラー。

ログや分析で 504 ステータスコードが見えることもあります。これは、Early Hints の cache MISS レスポンス、または Cloudflare Workers Cache API の cache.match 操作が cache MISS になった場合 ↗ が原因です。

解決方法

502/504 エラーを解決するには、問題がオリジン Web サーバー側か Cloudflare 側かを特定することが重要です。以降のセクションで、両方の切り分けと解決の詳細を説明します。

オリジン Web サーバーからの 502/504

オリジン Web サーバーが標準の HTTP 502 bad gateway または 504 gateway timeout エラーで応答すると、Cloudflare は Cloudflare ブランドの HTTP 502 または 504 エラーを返します。

次のよくある原因について、ホスティングプロバイダーへ問い合わせて、オリジン Web サーバー側を切り分けてください。

502 または 504 エラーが発生した訪問者の URL に含まれるホスト名とドメインに対して、オリジンサーバーが応答することを確認します。
サーバー負荷の過剰、クラッシュ、ネットワーク障害を調査します。
タイムアウトした、またはブロックされたアプリケーションやサービスを特定します。

Cloudflare からの 502/504

Cloudflare 起因の 502 または 504 エラーは、次のように Cloudflare ブランドのない空白ページとして表示されます。

エラーに cloudflare と書かれていない場合は、ホスティングプロバイダーへ問い合わせてください。詳細はオリジンからの 502/504 エラーを参照してください。

このエラーは、オリジン側の圧縮の問題で発生することがあります。たとえば、オリジンサーバーが gzip で圧縮したコンテンツを返しているのに content-length ヘッダーを更新していない場合や、壊れた gzip 圧縮コンテンツを返している場合です。切り分けとして、オリジン側の圧縮を無効にして、エラーが解消するかを確認できます。

また、特定のデータセンターでトラフィックが急増することがあります。影響を最小限に抑えるため、自動化された処理がトラフィックを別のデータセンターへ振り向けます。この調整は通常、数秒で途切れなく行われます。ただし、この過程で一部のクライアントに一時的な遅延や HTTP 502 エラーが出ることがあります。自動化されたトラフィック管理ツールの詳細は、このブログ記事 ↗ を参照してください。

サポートチームへ追加の支援を依頼する場合は、問い合わせの処理が遅れないよう、次の情報を Cloudflare サポートへ提供してください。

問題が発生した日時とタイムゾーン。
HTTP 502 または 504 レスポンスになった URL（例: https://www.example.com/images/icons/image1.png）。
<YOUR_DOMAIN>/cdn-cgi/trace を開いたときの出力。

HTTP エラー 502 または 504 につながる既知の Cloudflare の問題

Gateway を使っていると、オリジンが HTTP/2 を部分的にしかサポートしていない場合に HTTP エラー 502 になることがあります。詳細と解決方法はトラブルシューティングを参照してください。
Cloudflare Tunnel 経由で HTTP または HTTPS アプリケーションに接続すると、Unable to reach the origin service. The service may be down or it may not be responding to traffic from cloudflared とともに 502 Bad Gateway エラーが出ることがあります。トンネル自体は Cloudflare ネットワークへ接続できていますが、cloudflared が ingress ルールで定義したオリジンサービスに到達できない状態です。詳細と解決方法はトンネルのよくあるエラーを参照してください。
Early Hints を有効にしていると、Cloudflare Logs で RequestSource が earlyHintsCache の HTTP エラー 504 がまとまって見えることがあります。これは想定どおりで、問題ではありません。詳細と解決方法は Early Hints の記事を参照してください。
Dedicated CDN Egress IPs を使ってオリジンへ接続している場合、Cloudflare がオリジンへの新しい接続を開くときに、Dedicated CDN Egress IPs で使える送信元ポートが一時的に不足して 502 エラーになることもあります。Dedicated CDN Egress IP は、オリジンの IP とポートあたり最大 40,000 の同時接続をサポートします。1 つのオリジンへの同時接続が多いと、オリジンが健全でも利用可能なポートが尽き、断続的な 502 エラーにつながることがあります。Dedicated CDN Egress IPs は接続の再利用と coalescing（接続の統合）により、オリジンへ開く接続数が減り、この上限に達しにくくなります。ポート枯渇が疑われる場合は、アカウントチームへ連絡し、Dedicated CDN Egress IPs の容量と配置を確認してください。