エラーレスポンス

Cloudflare がリクエストを完了できないとき、エラーレスポンスを生成します。形式は、クライアントが Accept ヘッダーで要求する内容と、ゾーンの Custom Errors 設定によって決まります。

デフォルトのエラーレスポンスは HTML です。構造化形式（application/json、application/problem+json、text/markdown など）を要求するクライアントには、機械可読なレスポンスが返ります。この機械可読レスポンスは、すべての 1xxx エラーコード（エラーに応じて HTTP 4xx または 5xx を返す）と、Cloudflare が生成する 5xx エラー（500、502、504、520-526）を対象にします。オリジンサーバーが生成した 5xx エラーのレスポンスは、Cloudflare がクライアントへそのまま渡し、この仕組みの対象外です。

Cloudflare は、標準の HTTP コンテンツネゴシエーション ↗ に従い、クライアントの Accept ヘッダーでレスポンス形式を選びます。複数の形式が受け入れ可能なときは、品質係数（q 値）で優先順位を決めます。同じ品質値なら、先に書いた型が採用されます。

構造化エラーレスポンスは、Free プランを含むすべてのプランで利用できます。これらのレスポンスを上書きする Custom Error Rules には、Cloudflare の有料プランが必要です。

構造化エラーレスポンスは、カスタムエラー設定がないゾーンのデフォルトです。 Custom Errors を使うゾーンでは、クライアントへ返す内容をすべて制御できます。

クライアントが受け取る内容は、ゾーンに設定したカスタムエラー機能によって変わります。詳細は次の各節を参照してください。

ほとんどのゾーンのデフォルトです。Cloudflare は、クライアントが要求した形式でデフォルトのエラーレスポンスを返します。

ゾーンに、Cloudflare ダッシュボードからアップロードした Error Page があります。Custom Error Rules は未設定です。Error Page は Accept ヘッダーに関係なく、すべてのクライアントへ返されます。Error Pages はコンテンツネゴシエーションを行いません。

エージェントには構造化レスポンスを返しつつ、ブラウザーにはカスタム HTML を残したい場合は、Accept ヘッダーにマッチする Custom Error Rule を追加します。詳細は次の節を参照してください。

ゾーンに 1 つ以上の Custom Error Rules があります（有料プランで利用できます）。これらは Error Pages より優先されます。返す内容、対象、条件は自分で制御します。

Custom Error Rules は Accept を含む任意のリクエストヘッダーにマッチでき、特定のエラーコードを対象にできます。同じゾーンから、API クライアントには JSON、エージェントには Markdown、ブラウザーには HTML を返せます。

Cloudflare がエラーレスポンスを生成するとき、クライアントが受け取る内容は次の優先順位で決まります。

1. Custom Error Rules — ルールがエラーとリクエスト条件にマッチすれば、そのルールの内容が返ります。
2. Error Pages — エラータイプ向けの Error Page があり、Custom Error Rule にマッチしなければ、Accept ヘッダーに関係なく Error Page が HTML として返ります。
3. 構造化エラーレスポンス — Custom Error Rule にマッチせず、Error Page もなければ、Cloudflare はクライアントが要求した形式（JSON、Markdown、または HTML）でデフォルトレスポンスを返します。

アカウントレベルとゾーンレベルのルール、WAF のカスタムブロックレスポンス、セキュリティチャレンジページを含む全体の優先順位は、Custom Errors のドキュメントを参照してください。

{
	"type": "https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/error-522/",
	"title": "Error 522: Connection timed out",
	"status": 522,
	"detail": "Cloudflare could not establish a TCP connection to the origin server. The TCP handshake timed out, which may indicate the origin is overloaded, firewalling Cloudflare, or unreachable at the network level.",
	"instance": "9f140b785e57c458",
	"error_code": 522,
	"error_name": "connection_timeout",
	"error_category": "origin",
	"ray_id": "9f140b785e57c458",
	"timestamp": "2026-04-24T09:22:40Z",
	"zone": "example.com",
	"cloudflare_error": true,
	"retryable": true,
	"retry_after": 120,
	"owner_action_required": true,
	"what_you_should_do": "**Wait and retry.** Back off for at least 120 seconds. If the error persists, the website operator should verify firewall rules and ensure the origin accepts connections from Cloudflare IP ranges.",
	"footer": "This error was generated by Cloudflare on behalf of the website owner."
}

---
error_code: 522
error_name: connection_timeout
error_category: origin
status: 522
ray_id: 9f140b785e57c458
timestamp: 2026-04-24T09:22:40Z
zone: example.com
cloudflare_error: true
retryable: true
retry_after: 120
owner_action_required: true
---

# Error 522: Connection timed out

## What Happened

Cloudflare could not establish a TCP connection to the origin server. The TCP handshake timed out, which may indicate the origin is overloaded, firewalling Cloudflare, or unreachable at the network level.

## What You Should Do

**Wait and retry.** Back off for at least 120 seconds. If the error persists, the website operator should verify firewall rules and ensure the origin accepts connections from Cloudflare IP ranges.

---

This error was generated by Cloudflare on behalf of the website owner.

522 エラーの構造化 JSON レスポンスを取得します。

curl --silent --compressed --header "Accept: application/json" \
  --user-agent "TestAgent/1.0" --header "Accept-Encoding: gzip, deflate" \
  "https://example.com/cdn-cgi/error/522" | jq .

構造化 Markdown レスポンスを取得します。

curl --silent --compressed --header "Accept: text/markdown" \
  --user-agent "TestAgent/1.0" --header "Accept-Encoding: gzip, deflate" \
  "https://example.com/cdn-cgi/error/522"

再試行可能なエラーの Retry-After ヘッダーを確認します。

curl --silent --compressed --dump-header - --output /dev/null \
  --header "Accept: application/json" --user-agent "TestAgent/1.0" \
  --header "Accept-Encoding: gzip, deflate" \
  "https://example.com/cdn-cgi/error/521" | grep -i retry-after

JSON と Markdown のレスポンスは、同じフィールドセットを含みます。JSON はフラットなオブジェクトとして返し、Markdown は YAML frontmatter のあとに本文セクションを置きます。次のフィールド定義は両方の形式に適用されます。

JSON レスポンスは RFC 9457（Problem Details for HTTP APIs） ↗ に従います。Problem Details を理解する任意の HTTP クライアントは、Cloudflare 固有のコードなしで、標準の 5 メンバー（type、title、status、detail、instance）をパースできます。

Markdown レスポンスは、これらのフィールドを YAML frontmatter（--- 区切り）に置き、そのあとに 3 つの本文セクションを続けます。

• # Error {code}: {description} — エラーコードと短い説明の見出しです。
• ## What Happened — detail フィールドに対応します。
• ## What You Should Do — what_you_should_do フィールドに対応します。

frontmatter は、RFC 9457 の標準メンバー（type、title、instance）と footer フィールドを省略します。本文と重複するか、Markdown 形式では不要なためです。

error_category フィールドは障害を分類します。クライアントは本文フィールドをパースせずに、再試行とエスカレーションの動きを振り分けられます。

再試行可能なエラーコードには、標準の Retry-After ↗ HTTP レスポンスヘッダーが付きます。ヘッダーの秒数は、レスポンス本文の retry_after フィールドと一致します。

再試行不可のコード（525、526）には Retry-After ヘッダーは付きません。

再試行可能な 1xxx エラーコードのうち、Retry-After を返すのは次の 6 つです。

その他の 1xxx エラーコードは再試行不可で、Retry-After ヘッダーは付きません。

WAF のレート制限ルールが、レスポンスに動的な Retry-After 値をすでに設定している場合は、その値がデフォルトより優先されます。

• Cloudflare 1xxx エラー
• Cloudflare 5xx エラー
• Custom Errors
• 接続制限
• Markdown for Agents（コンテンツ変換）
• RFC 9457 — Problem Details for HTTP APIs ↗