WebGroundwebground.app
情報&ガイド · Web技術資料

HTTPステータスコード&デバッグ早見表

1xx〜5xxのHTTPレスポンスコードの意味と、APIやCDNトラブルシューティングの実践ヒントを即座に検索できます。

表示中: 26 件
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クエリを最適化するか、重い処理を非同期バックグラウンドジョブへ移してください。

400 Bad RequestやAPIのJSONペイロードを今すぐデバッグしますか?JSONフォーマッターを開く

HTTPステータスコード5つの分類を理解する

すべてのHTTPレスポンスはRFC 9110で定義された3桁のステータスコードから始まります。先頭1桁を見るだけで、開発者やSRE、SEO担当者は問題の種類を瞬時に切り分けられます。

1xxは情報・プロトコル切替、2xxは成功、3xxはキャッシュやリダイレクト、4xxはクライアント側のリクエスト不備、5xxはオリジンやプロキシのサーバー障害を示します。

実務で迷いやすいステータスコードの違い

似たコード間の細かな違いを押さえておくと、障害解析が格段に速くなります:

  • 401 Unauthorized vs 403 Forbidden:401は認証情報の欠如・期限切れ(再認証が必要)、403は認証済みまたはポリシー判定によりアクセス権限自体が拒否された状態です。
  • 301/302 vs 307/308:従来の301/302はリダイレクト時にPOSTがGETへ変わる場合がありますが、307と308は元のHTTPメソッドとボディを厳密に保持します。
  • 502 Bad Gateway vs 504 Gateway Timeout:502は上流サーバーからの不正応答、504は上流サーバーの応答待ちタイムアウトを意味します。

よくある質問 (FAQ)

401と403の違いは何ですか?+

401 Unauthorizedは認証資格情報が未指定・期限切れ・無効な状態、403 Forbiddenは権限不足やWAF/CORSポリシーによってアクセスが拒否された状態です。

429 Too Many Requestsにはどう対処すべきですか?+

Retry-Afterレスポンスヘッダーがある場合はその秒数待機し、ジッター付き指数バックオフ(Exponential Backoff)でリトライしてください。

204 No Contentでresponse.json()がエラーになるのはなぜですか?+

204レスポンスは仕様上ボディが空であるためJSONパースに失敗します。パース前にresponse.status === 204を確認してください。

WebGroundの他のツールを見る

すべて表示