Continue
初期ヘッダーを受信しました。クライアントはリクエストボディを送信できます。
ヒント: 大容量送信時に Expect: 100-continue ヘッダーと併用されます。
1xx〜5xxのHTTPレスポンスコードの意味と、APIやCDNトラブルシューティングの実践ヒントを即座に検索できます。
初期ヘッダーを受信しました。クライアントはリクエストボディを送信できます。
ヒント: 大容量送信時に Expect: 100-continue ヘッダーと併用されます。
サーバーがプロトコル切替(主にHTTPからWebSocket)に同意しました。
ヒント: WebSocket接続が止まる場合は Upgrade / Connection ヘッダーを確認してください。
HTTPリクエストが正常に成功したことを示す標準応答です。
ヒント: 描画に失敗する場合は Content-Type とJSON構造を確認してください。
リクエストが成功し、新しいリソースが作成されました。
ヒント: REST APIでは通常 Location ヘッダーに作成されたリソースURLが入ります。
リクエストは成功し、サーバーが意図的に空のボディを返しました。
ヒント: DELETEやCORS OPTIONSの204応答では response.json() を呼ばないでください。
指定されたバイト範囲(Range)のデータのみを配信しました。
ヒント: 動画ストリーミングやレジューム対応ダウンロードで Range ヘッダーと使われます。
リソースが新しいURLへ恒久的に移動し、SEO評価も引き継がれます。
ヒント: ブラウザは301を強くキャッシュするため、シークレットや curl -I で検証しましょう。
一時的に別URLで提供されており、元のURLのインデックスを保持します。
ヒント: OAuth認証フローや一時的なメンテナンス誘導によく使われます。
ETagやLast-Modifiedに基づき、キャッシュ済みのコピーが依然有効です。
ヒント: 静的アセットの通信量を削減します。古いままなら Cache-Control を確認してください。
元のHTTPメソッドとボディを保持する一時的リダイレクトです。
ヒント: リダイレクト後もPOSTメソッドを維持したい場合は302ではなく307を使います。
元のHTTPメソッドとボディを保持する恒久的リダイレクトです。
ヒント: Next.jsのtrailingSlash正規化やHTTPS統一リダイレクトでよく使われます。
構文エラーや不正なパラメータのためサーバーがリクエストを処理できません。
ヒント: JSON構文、必須クエリ項目、Content-Type ヘッダーを検証してください。
認証情報が不足しているか、期限切れ・無効になっています。
ヒント: Authorization Bearerトークンの有効期限、APIキー、セッションCookieを確認してください。
クライアントは識別されている(またはポリシー遮断)がアクセス権限がありません。
ヒント: RBAC権限、CORS/WAFルール、ストレージバケット権限を確認してください。
要求されたルートまたはリソースが見つかりません。
ヒント: 末尾スラッシュ、ベースパス、DNSルーティング、削除済みIDを確認してください。
URLは存在しますが、使用されたHTTPメソッド(GET/POSTなど)が非対応です。
ヒント: Allow レスポンスヘッダーを確認し、許可されたメソッドを確認してください。
クライアントがリクエスト送信を完了する前にサーバーがタイムアウトしました。
ヒント: 低速なモバイル回線でのアップロードや keep-alive 設定の不一致を確認してください。
対象リソースの現在の状態とリクエストが競合しています。
ヒント: 重複メールアドレス登録や楽観的ロック(ETag)不一致でよく発生します。
ペイロードサイズがサーバーまたはリバースプロキシの上限を超えています。
ヒント: 送信前にクライアントで画像を圧縮するか、プロキシの上限を引き上げてください。
Content-Type に指定された形式をサーバーが受け付けません。
ヒント: Content-Type が実際のボディ(application/json等)と一致するか確認してください。
JSON構文は正しいものの、値の意味的なバリデーションに失敗しました。
ヒント: メール形式エラー、負の数値、必須enum欠落などの詳細エラーを確認してください。
クライアントがAPIのレート制限(クォータ)を超過しました。
ヒント: Retry-After ヘッダーに従い、ジッター付き指数バックオフで再試行してください。
オリジンサーバー上で予期せぬ未処理例外が発生しました。
ヒント: サーバーのスタックトレース、環境変数不足、DB障害を確認してください。
プロキシやCDNが上流サーバーから無効な応答を受け取りました。
ヒント: 上流アプリプロセスが起動しており正しいポートで待受しているか確認してください。
サーバーが一時的な過負荷または計画メンテナンス中です。
ヒント: Retry-After ヘッダー、ヘルスチェック失敗、コールドスタート枯渇を確認してください。
プロキシまたはCDNが上流サーバーの応答待ちでタイムアウトしました。
ヒント: 遅いDBクエリを最適化するか、重い処理を非同期バックグラウンドジョブへ移してください。
| コード | ステータス名 | 意味 | デバッグのヒント | コピー |
|---|---|---|---|---|
| 100 | Continue | 初期ヘッダーを受信しました。クライアントはリクエストボディを送信できます。 | 大容量送信時に Expect: 100-continue ヘッダーと併用されます。 | |
| 101 | Switching Protocols | サーバーがプロトコル切替(主にHTTPからWebSocket)に同意しました。 | WebSocket接続が止まる場合は Upgrade / Connection ヘッダーを確認してください。 | |
| 200 | OK | HTTPリクエストが正常に成功したことを示す標準応答です。 | 描画に失敗する場合は Content-Type とJSON構造を確認してください。 | |
| 201 | Created | リクエストが成功し、新しいリソースが作成されました。 | REST APIでは通常 Location ヘッダーに作成されたリソースURLが入ります。 | |
| 204 | No Content | リクエストは成功し、サーバーが意図的に空のボディを返しました。 | DELETEやCORS OPTIONSの204応答では response.json() を呼ばないでください。 | |
| 206 | Partial Content | 指定されたバイト範囲(Range)のデータのみを配信しました。 | 動画ストリーミングやレジューム対応ダウンロードで Range ヘッダーと使われます。 | |
| 301 | Moved Permanently | リソースが新しいURLへ恒久的に移動し、SEO評価も引き継がれます。 | ブラウザは301を強くキャッシュするため、シークレットや curl -I で検証しましょう。 | |
| 302 | Found (Temporary Redirect) | 一時的に別URLで提供されており、元のURLのインデックスを保持します。 | OAuth認証フローや一時的なメンテナンス誘導によく使われます。 | |
| 304 | Not Modified | ETagやLast-Modifiedに基づき、キャッシュ済みのコピーが依然有効です。 | 静的アセットの通信量を削減します。古いままなら Cache-Control を確認してください。 | |
| 307 | Temporary Redirect | 元のHTTPメソッドとボディを保持する一時的リダイレクトです。 | リダイレクト後もPOSTメソッドを維持したい場合は302ではなく307を使います。 | |
| 308 | Permanent Redirect | 元のHTTPメソッドとボディを保持する恒久的リダイレクトです。 | Next.jsのtrailingSlash正規化やHTTPS統一リダイレクトでよく使われます。 | |
| 400 | Bad Request | 構文エラーや不正なパラメータのためサーバーがリクエストを処理できません。 | JSON構文、必須クエリ項目、Content-Type ヘッダーを検証してください。 | |
| 401 | Unauthorized | 認証情報が不足しているか、期限切れ・無効になっています。 | Authorization Bearerトークンの有効期限、APIキー、セッションCookieを確認してください。 | |
| 403 | Forbidden | クライアントは識別されている(またはポリシー遮断)がアクセス権限がありません。 | RBAC権限、CORS/WAFルール、ストレージバケット権限を確認してください。 | |
| 404 | Not Found | 要求されたルートまたはリソースが見つかりません。 | 末尾スラッシュ、ベースパス、DNSルーティング、削除済みIDを確認してください。 | |
| 405 | Method Not Allowed | URLは存在しますが、使用されたHTTPメソッド(GET/POSTなど)が非対応です。 | Allow レスポンスヘッダーを確認し、許可されたメソッドを確認してください。 | |
| 408 | Request Timeout | クライアントがリクエスト送信を完了する前にサーバーがタイムアウトしました。 | 低速なモバイル回線でのアップロードや keep-alive 設定の不一致を確認してください。 | |
| 409 | Conflict | 対象リソースの現在の状態とリクエストが競合しています。 | 重複メールアドレス登録や楽観的ロック(ETag)不一致でよく発生します。 | |
| 413 | Content Too Large | ペイロードサイズがサーバーまたはリバースプロキシの上限を超えています。 | 送信前にクライアントで画像を圧縮するか、プロキシの上限を引き上げてください。 | |
| 415 | Unsupported Media Type | Content-Type に指定された形式をサーバーが受け付けません。 | Content-Type が実際のボディ(application/json等)と一致するか確認してください。 | |
| 422 | Unprocessable Content | JSON構文は正しいものの、値の意味的なバリデーションに失敗しました。 | メール形式エラー、負の数値、必須enum欠落などの詳細エラーを確認してください。 | |
| 429 | Too Many Requests | クライアントがAPIのレート制限(クォータ)を超過しました。 | Retry-After ヘッダーに従い、ジッター付き指数バックオフで再試行してください。 | |
| 500 | Internal Server Error | オリジンサーバー上で予期せぬ未処理例外が発生しました。 | サーバーのスタックトレース、環境変数不足、DB障害を確認してください。 | |
| 502 | Bad Gateway | プロキシやCDNが上流サーバーから無効な応答を受け取りました。 | 上流アプリプロセスが起動しており正しいポートで待受しているか確認してください。 | |
| 503 | Service Unavailable | サーバーが一時的な過負荷または計画メンテナンス中です。 | Retry-After ヘッダー、ヘルスチェック失敗、コールドスタート枯渇を確認してください。 | |
| 504 | Gateway Timeout | プロキシまたはCDNが上流サーバーの応答待ちでタイムアウトしました。 | 遅いDBクエリを最適化するか、重い処理を非同期バックグラウンドジョブへ移してください。 |
すべてのHTTPレスポンスはRFC 9110で定義された3桁のステータスコードから始まります。先頭1桁を見るだけで、開発者やSRE、SEO担当者は問題の種類を瞬時に切り分けられます。
1xxは情報・プロトコル切替、2xxは成功、3xxはキャッシュやリダイレクト、4xxはクライアント側のリクエスト不備、5xxはオリジンやプロキシのサーバー障害を示します。
似たコード間の細かな違いを押さえておくと、障害解析が格段に速くなります:
401 Unauthorizedは認証資格情報が未指定・期限切れ・無効な状態、403 Forbiddenは権限不足やWAF/CORSポリシーによってアクセスが拒否された状態です。
Retry-Afterレスポンスヘッダーがある場合はその秒数待機し、ジッター付き指数バックオフ(Exponential Backoff)でリトライしてください。
204レスポンスは仕様上ボディが空であるためJSONパースに失敗します。パース前にresponse.status === 204を確認してください。