Cloudflare 経由の 504 Gateway Timeout

このエラーの意味と見分け方

• エラーページに Cloudflare のブランドが表示され、通常はサイト本来のエラーレイアウトではなく Cloudflare Ray ID が含まれます。
• 特定のレポート、エクスポート、アップロード、API 呼び出し、一括操作が失敗する一方で、通常のページは読み込みできます。
• 同じリクエストをオリジンに対して直接テストすると、応答が遅い、タイムアウトする、または失敗することがあります。
• オリジンに過負荷がかかっている場合は問題が断続的に発生し、Cloudflare が設定済みのオリジンに接続できない場合は一貫して発生することがあります。
• アプリケーションまたは Web サーバーのログに、リクエストは開始されたものの、クライアント向けタイムアウトまでに完了しなかったことが記録される場合があります。

可能性の高い順の主な原因

1. オリジンの処理に時間がかかっている。 データベースクエリ、レポート、エクスポート、アップロード、その他の同期処理が、Cloudflare の待機可能時間を超えることがあります。
2. リクエストが Cloudflare のタイムアウト制限に達している。 適用される制限は、リクエスト、アカウント設定、プランによって異なります。オリジンの Web サーバーのタイムアウトを延長しても、Cloudflare のエッジ側の制限は延長されません。
3. Cloudflare がオリジンに安定して到達できない。 ファイアウォールルール、ネットワーク障害、誤った DNS ターゲット、利用できないサービス、接続の飽和により、時間内に応答できないことがあります。
4. エンドポイントがプロキシに適していない。 内部 API や特殊な API では、Cloudflare のプロキシを通すのではなく、慎重に管理された DNS-only 構成が必要になる場合があります。
5. SSL/TLS 設定がオリジンと一致していない。 Full (strict) を使用している場合は、オリジン証明書、ホスト名、証明書の有効性を確認してください。証明書の問題は他の Cloudflare オリジンエラーを引き起こす可能性があるため、すべての SSL 問題が 504 だと決めつけず、実際のレスポンスを確認してください。

修正方法

1. Cloudflare がレスポンスを生成したことを確認する

エラーページに Cloudflare のブランドと Ray ID が表示されているか確認し、アプリケーション本来のエラーページと比較します。Cloudflare がページを生成している場合、アプリケーションのエラーハンドリングだけを変更しても、エッジからオリジンへの問題は解決しません。

2. 範囲と発生タイミングを特定する

正確なホスト名とパス、HTTP メソッド、ユーザー操作、おおよその開始時刻、問題がすべての訪問者に影響するのか特定の操作だけに影響するのかを記録します。通常のページは動作する一方で、レポート、エクスポート、API リクエストが失敗していないか確認します。

1つの負荷の高い操作に限られる場合は、バックエンドの処理時間が原因である可能性が高くなります。通常の高速なリクエストでも失敗する場合は、オリジンへの到達性、容量、設定が原因である可能性が高くなります。

3. オリジンを個別にテストする

必要なホスト名、Host ヘッダー、TLS の動作、認証、ルーティングを維持した、承認済みのオリジン直接テストを実施します。安全に設定し、オリジンへのアクセスを適切に制限できる場合は、一時的な DNS-only のテスト用ホスト名が役立つことがあります。

• オリジンも遅い、または失敗する場合： アプリケーションログ、データベースクエリ、ワーカー容量、上流の依存サービス、サーバー負荷、接続の飽和を確認します。
• オリジンは高速だが公開ホスト名が 504 を返す場合： Cloudflare からオリジンへのファイアウォールアクセス、DNS、SSL/TLS 設定、プロキシステータス、対象エンドポイントを調査します。
• 直接テストが実際のリクエストを適切に再現していない場合： 失敗したリクエストと同じ認証、ホストベースのルーティング、ヘッダー、その他の要件で再テストします。

4. 実際に時間のかかる操作を修正する

レポート、エクスポート、一括操作、その他の長時間処理では、すべての処理が完了するまで1つのブラウザーリクエストを開いたままにしないでください。処理をバックグラウンドジョブに移し、処理中の状態を表示し、ポーリングまたは完了通知によってユーザーが結果を取得できるようにします。

データベースクエリ、アプリケーショントレース、上流サービスへの呼び出し、キューの深さ、リソース使用量も測定します。測定せずにオリジンのタイムアウト延長を主な対策にしないでください。Cloudflare が先に制限へ達した場合、オリジンが不要な処理を続けている一方で、訪問者にはエラーが表示される可能性があります。

5. 適用される Cloudflare のタイムアウトを確認する

対象のリクエストとプランに適用されるタイムアウトについて、Cloudflare アカウントと関連ドキュメントを確認します。処理自体は正当でも固定された制限時間内に完了できない場合、実用的な選択肢は、非同期処理として設計し直すこと、または必要なタイムアウトに対応するアカウント設定とプラン（利用可能な場合）を使用することです。

6. 問題が継続する場合は到達性を確認する

通常の高速なリクエストも失敗する場合は、次を確認します。

• DNS レコードが現在のオリジンアドレスを指している。
• オリジンのファイアウォールが必要に応じて Cloudflare のトラフィックを許可し、不要なサービスは公開していない。
• Web サーバーが想定されたポートで待ち受け、要求されたホスト名を受け付けている。
• オリジンに十分な容量があり、接続を破棄またはキュー滞留させていない。
• SSL/TLS モードがオリジン証明書、ホスト名、証明書の有効性と一致している。特に Full (strict) では注意する。
• 対象レコードがプロキシ経由を意図したものか、管理された DNS-only 構成で提供すべきものか確認する。

DNS、ファイアウォール、SSL/TLS、プロキシを変更する場合は、適切な承認とロールバック計画のもとでのみ実施してください。重要な変更を行うたびに、原因と結果を明確に保てるよう、失敗している正確なエンドポイントを再テストします。

7. 有用な証拠を添えてエスカレーションする

オリジンが正常で、同等の直接テストですぐに応答する場合は、Ray ID、タイムゾーンを含むタイムスタンプ、ホスト名、パス、リクエストメソッド、対象の Cloudflare ゾーン、直接テストの結果を収集します。エッジからオリジンへの動作を調査できるよう、この情報を Cloudflare アカウント管理者またはサポート窓口に提供します。

予防と修正確認

• Cloudflare 経由の可用性とは別に、オリジンの応答時間とリクエスト全体の処理時間を測定します。
• 予測可能な長時間のレポート、エクスポート、アップロード、一括操作は、進捗または完了状態を表示するバックグラウンドジョブで処理します。
• ユーザーがタイムアウトに遭遇する前に、オリジンのレイテンシー上昇、接続失敗、リソースの飽和、キューの深さを検知できるようアラートを設定します。
• DNS レコード、オリジンのファイアウォールルール、Cloudflare トラフィックの許可リストを変更管理下に置きます。
• Full (strict) を使用している場合は、オリジン証明書の有効性とホスト名のカバレッジを監視し、デプロイ前に SSL/TLS の変更を確認します。
• Cloudflare のプロキシを使用するエンドポイントと、管理された DNS-only 構成が必要なエンドポイントを文書化します。
• インフラ、DNS、ファイアウォール、証明書、プロキシを変更した後は、代表的なオリジン接続を再テストします。

よくある質問