HTTPステータスコード一覧

クライアントが Expect: 100-continue を付けて送ったとき、サーバーがヘッダーだけを見て「本文を送ってよい」と答える中間応答。大きなファイルをアップロードする前に、認証やサイズ制限で弾かれないかを先に確かめられる。最終的な応答はこのあとに別途返る。

1xx 情報 キャッシュしない 本文を持てない

クライアントの Upgrade 要求を受け入れ、この接続を別のプロトコルに切り替えることを伝える。実際にはほぼ WebSocket のハンドシェイクで見る。切り替え後は HTTP のセマンティクスは終わり、以降は新しいプロトコルの通信になる。

1xx 情報 キャッシュしない 本文を持てない

WebDAV で、時間のかかる操作の途中に「まだ生きている」ことを伝えるために返す中間応答。RFC 4918 で定義されたが、実装が広がらず RFC 9110 では非推奨扱いになった。同じ目的なら 103 Early Hints のほうが現実的。

1xx 情報 キャッシュしない 本文を持てない 非推奨・廃止

本応答を組み立てている間に Link: </style.css>; rel=preload などを先に送り、ブラウザに CSS や画像の取得を始めさせる。サーバー側の生成に時間がかかるページで表示開始を早められる。Cloudflare や Fastly が対応しており、対応しないクライアントは単に無視する。

1xx 情報 キャッシュしない 本文を持てない

もっともよく見る成功応答。本文の意味はメソッドによって変わり、GET なら要求されたリソース、POST なら処理の結果を表す。API で「処理は成功したが結果は空」を返したいときは 204 のほうが正確。

実務メモ: エラーを本文の中に {"error":...} として入れて 200 で返す API は、CDN・ブラウザ・監視のどれもが成功として扱うため障害に気づけなくなる。失敗は 4xx / 5xx で返す。

2xx 成功 既定でキャッシュ可 本文あり

POST や PUT で新しいリソースが作られたときに返す。作られた場所を Location ヘッダーで示し、本文には作成されたリソースの表現を入れるのが一般的。同じリクエストを再送したときに二重作成にならない設計(冪等キー)は別途必要。

2xx 成功 キャッシュしない 本文あり

非同期処理のキューに入れたときに返す。処理が成功したかどうかはこの時点では分からないので、本文や Location で進捗を確認できる URL を返すのが親切。バッチ・メール送信・動画変換などで使う。

2xx 成功 キャッシュしない 本文あり

オリジンは 200 を返したが、間にいるプロキシがヘッダーや本文を加工したことを示す。企業内プロキシによる書き換えなどで使われるが、実際に見る機会はごく少ない。

2xx 成功 既定でキャッシュ可 本文あり

処理は成功したが返すものが無いときに使う。DELETE の完了、設定の保存、既読フラグの更新などが典型。**本文を持てない**ので、ここに JSON を入れるとクライアントによっては壊れる。ブラウザは画面遷移せずその場に留まる。

2xx 成功 既定でキャッシュ可 本文を持てない

204 に「入力欄を空に戻せ」という指示が加わったもの。連続入力する業務フォームのために定義されたが、対応するクライアントはほとんど無く、実際には JavaScript 側でリセットするほうが確実。

2xx 成功 キャッシュしない 本文を持てない

クライアントの Range ヘッダーに応えて本文の一部だけを返す。動画のシーク、ダウンロードの再開、大きなファイルの分割取得で使われる。Content-Range で返した範囲を示し、レスポンスは 200 とは別にキャッシュされる。

2xx 成功 既定でキャッシュ可 本文あり

WebDAV で、複数のファイルやプロパティに対する操作の結果を 1 つの応答にまとめる。本文の XML の中に対象ごとのステータスが入っているので、全体は 207 でも個々は 404 や 423 でありうる。

2xx 成功 キャッシュしない 本文あり

207 の本文の中で、同じリソースが何度も現れるときに繰り返しを省くために使う。バインディングで循環する構造を持つ WebDAV コレクションの列挙で必要になる。

2xx 成功 キャッシュしない 本文あり

RFC 3229 のデルタエンコーディングで、クライアントが持っている版との差分だけを返したことを示す。帯域を節約する仕組みだが実装はほぼ普及しなかった。

2xx 成功 既定でキャッシュ可 本文あり

同じ URL に対して言語違い・形式違いの候補が複数あるときに、その一覧を返す。実際にはサーバー側で Accept-Language を見て選ぶ(サーバー駆動のコンテンツネゴシエーション)ほうが普通で、300 を返すサイトはまず無い。

3xx リダイレクト 既定でキャッシュ可 本文あり

URL が恒久的に変わったことを示し、Location で移転先を伝える。検索エンジンは評価を移転先に引き継ぐので、サイト構成を変えるときの正しい手段。ブラウザはこの応答を**強くキャッシュ**し、次からはサーバーに問い合わせずに移転先へ飛ぶ。

実務メモ: 301 は事実上取り消せない。一度受け取ったブラウザは期限なしでリダイレクトを覚えるため、あとでサーバー側を戻しても、そのブラウザは新 URL へ飛び続ける。切り戻す可能性がある移転・A/B・メンテナンス中の誘導には 302 か 307 を使う。

3xx リダイレクト 既定でキャッシュ可 本文あり

一時的な転送。検索エンジンは元の URL を索引に残す。歴史的な事情で、多くのクライアントが POST を GET に変えて転送先へ行ってしまうため、メソッドを保ちたいときは 307 を使う。

3xx リダイレクト キャッシュしない 本文あり

POST の処理後に「結果ページを GET で見に行け」と伝えるためのコード。フォーム送信 → リダイレクト → 表示(PRG パターン)にすると、再読み込みで二重送信になるのを防げる。メソッドは必ず GET に変わる。

3xx リダイレクト キャッシュしない 本文あり

条件付きリクエスト(If-None-Match / If-Modified-Since)に対して「前回から変わっていない」と答える。**本文を持たない**ので通信量がほぼゼロになる。ETag を返していれば自動的にこの往復が成立する。

3xx リダイレクト 条件付き 本文を持てない

指定したプロキシを通して取得するよう指示するコードだったが、任意のプロキシへ誘導できる危険があるため廃止された。現在のブラウザは無視する。

3xx リダイレクト キャッシュしない 本文あり 非推奨・廃止

初期の草案で使われていたが仕様から外れ、現在は予約されたまま使われない。番号の連続を保つために欠番として残っている。

3xx リダイレクト キャッシュしない 本文を持てない 非推奨・廃止

302 の曖昧さを解消したコードで、POST は POST のまま転送先へ送られる。HSTS の内部的な昇格や、メンテナンス中の一時的な振り替えに向く。切り戻す前提があるならこちらを選ぶ。

3xx リダイレクト キャッシュしない 本文あり

301 と同じく恒久的な移転だが、メソッドを変えない。API のエンドポイント移転のように POST/PUT を保ったまま移したいときに使う。301 と同様、ブラウザに強くキャッシュされるので取り消しは効かない。

3xx リダイレクト 既定でキャッシュ可 本文あり

JSON が壊れている、必須パラメータが無い、ヘッダーの書式が不正など、リクエストそのものに問題があるときに返す。認証の失敗は 401、権限不足は 403、値は正しい形だが業務上受け付けられない場合は 422 のほうが正確。

4xx クライアントエラー キャッシュしない 本文あり

名前に反して意味は「未認証」。WWW-Authenticate ヘッダーで受け付ける認証方式を示す必要がある。ログインすれば見られるページはこれ、ログイン済みでも権限が足りないなら 403。

4xx クライアントエラー キャッシュしない 本文あり

長らく「将来のために予約」とされてきたが、近年は API の課金プランの上限超過や未払いを示すために実際に使われる。標準の課金フローは定義されていないので、本文で理由と復旧方法を伝える。

4xx クライアントエラー キャッシュしない 本文あり

サーバーが要求を理解したうえで拒否した。再認証しても結果は変わらない。存在自体を隠したいときは 404 を返す運用もあるが、その場合は正規の利用者にも見つけられなくなることを承知しておく。

4xx クライアントエラー 既定でキャッシュ可 本文あり

URL に対応するものが無い。「一時的に無いのか、恒久的に消えたのか」を意図的に区別しないコードなので、クローラーはしばらく再訪して確かめ続ける。URL の打ち間違いや、まだ作っていないページに使う。

実務メモ: 「消したページは 404 にしておけば、いずれ検索エンジンが諦める」は誤り。Google は一度見つけた URL を数ヶ月〜数年にわたり再クロールし、その間クロール予算が生きているページに回らない。意図的に消したなら 410 を返す。

4xx クライアントエラー 既定でキャッシュ可 本文あり

リソースは存在するが、そのメソッドは受け付けない。Allow ヘッダーで使えるメソッドを列挙することが必須。読み取り専用のエンドポイントに POST が来たときなどに返す。

4xx クライアントエラー 既定でキャッシュ可 本文あり

Accept 系ヘッダーの条件を満たす表現をサーバーが用意できないときに返す。実際には条件を無視して既定の形式を返す実装が多く、見かける機会は少ない。

4xx クライアントエラー キャッシュしない 本文あり

401 のプロキシ版で、Proxy-Authenticate ヘッダーを伴う。企業ネットワークの認証プロキシ配下で作業しているときに出会う。

4xx クライアントエラー キャッシュしない 本文あり

接続は開いたのにリクエストが完結しないままサーバーの待ち時間を超えた。回線が細い状態での大きなアップロードや、開いたままの持続接続で起きる。504 はこれとは別で、上流の応答待ちの失敗を指す。

4xx クライアントエラー キャッシュしない 本文あり

同じメールアドレスでの二重登録、他の人が先に更新していた、すでに締め切られた、といった状態の衝突を表す。本文でどう解消すればよいかを伝えると、クライアント側で再試行の判断ができる。

4xx クライアントエラー キャッシュしない 本文あり

404 と違い「恒久的に消した」と明言するコード。検索エンジンはこれを受け取ると索引から速やかに落とし、再クロールをやめる。ページを整理・統合したとき、移転先が無いなら 410 を返すのが正しい後始末になる。

実務メモ: 静的サイトでも実装できる。410 を返すだけの小さな Worker を対象プレフィックスにだけ通せばよく、本文はそのまま返してステータスだけ 410 にできるので、利用者の見た目を変えずにクローラーだけ止められる。

4xx クライアントエラー 既定でキャッシュ可 本文あり

本文の長さが分からないリクエストを拒否する。チャンク転送を受け付けないサーバーや、事前にサイズで弾きたい構成で返る。

4xx クライアントエラー キャッシュしない 本文あり

If-Match などで指定した条件が満たされないときに返る。「自分が読んだ版のままなら更新する」という楽観的ロックの失敗を表し、更新の取りこぼしを防ぐ仕組みとして使える。

4xx クライアントエラー キャッシュしない 本文あり

アップロードのサイズ上限を超えた。旧称は Payload Too Large。nginx なら client_max_body_size、Cloudflare Workers ならプラン上限が原因になりやすい。一時的な制限なら Retry-After を添えられる。

4xx クライアントエラー キャッシュしない 本文あり

GET のクエリ文字列に大量のデータを詰めたときに起きる。多くのサーバーは 8KB 前後で打ち切る。長いデータは POST の本文に移すか、状態を保存して短い ID で参照する。

4xx クライアントエラー 既定でキャッシュ可 本文あり

JSON しか受け付けない API に text/plain で送った、対応していない画像形式をアップロードした、といったときに返る。Accept-Post などで受け付ける形式を示すと親切。

4xx クライアントエラー キャッシュしない 本文あり

Range で要求されたバイト範囲が実際の長さを超えている。ファイルが差し替わったあとに古い範囲で再開しようとした場合などに起きる。

4xx クライアントエラー キャッシュしない 本文あり

Expect: 100-continue などの期待にサーバーが応えられないときに返す。プロキシが Expect を理解しない構成で見ることがある。

4xx クライアントエラー キャッシュしない 本文あり

1998 年のエイプリルフール RFC 2324(ハイパーテキストコーヒーポット制御プロトコル)で定義されたジョークコード。標準の HTTP には含まれないが、あまりに有名になったため多くのフレームワークが定数として持っている。IETF は 2017 年に「予約したまま残す」ことを確認した。

4xx クライアントエラー キャッシュしない 本文あり

Laravel が CSRF トークンの期限切れに使う非標準コード。フォームを開いたまま長時間放置して送信すると出る。標準では 400 か 403 に相当する。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · Laravel

旧 Twitter API v1 がレート制限に使っていた非標準コードで、映画『デモリションマン』の台詞に由来する。現在は標準の 429 に置き換えられている。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · Twitter API v1

HTTP/2 で複数のホスト名が 1 本の接続にまとめられたとき、証明書は合っていてもそのサーバーが対象ホストを扱えない場合に返る。クライアントは別の接続を張り直して再試行してよい。

4xx クライアントエラー キャッシュしない 本文あり

JSON としては読めるが、日付が過去だった、在庫を超えていた、といった意味の上での不備を表す。400 が「読めない」なのに対し、422 は「読めたが受け付けられない」。バリデーションエラーの返却先として広く使われる。

4xx クライアントエラー キャッシュしない 本文あり

WebDAV で、他の利用者がロックを保持しているリソースを操作しようとしたときに返る。ロックトークンを持っていれば操作できる。

4xx クライアントエラー キャッシュしない 本文あり

複数の操作をまとめて依頼したとき、先の操作が失敗したためにこの操作も実行しなかったことを示す。207 の本文の中で個々の結果として現れることが多い。

4xx クライアントエラー キャッシュしない 本文あり

TLS 1.3 の 0-RTT で送られた早期データは攻撃者に再送される可能性があるため、副作用のある要求は受け付けずに再送を求める。決済のように二重実行が困る操作を守る仕組み。

4xx クライアントエラー キャッシュしない 本文あり

サーバーが要求するプロトコル(古い HTTP からの移行、TLS の要求など)へ切り替えるよう促す。Upgrade ヘッダーで必要なプロトコルを示す。

4xx クライアントエラー キャッシュしない 本文あり

更新を無条件に受け付けると、他の人の変更を知らずに上書きしてしまう。サーバーが If-Match を必須にすることで、この取りこぼしを防ぐために返す。

4xx クライアントエラー キャッシュしない 本文あり

レート制限に掛かった。Retry-After で待つべき秒数を示すのが作法で、これが無いとクライアントは総当たりで再試行してしまう。API の防御と、クローラーの過剰なアクセスの抑制の両方で使う。

4xx クライアントエラー キャッシュしない 本文あり

Shopify が 429 とは別に使う独自コード。同社の一部エンドポイントでリクエスト過多を示す。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · Shopify

Cookie が肥大化したときによく起きる。1 つのヘッダーが長すぎる場合も、合計が上限を超えた場合もある。原因の Cookie を消せば直ることが多い。

4xx クライアントエラー キャッシュしない 本文あり

Microsoft IIS が、セッションの有効期限切れで再ログインが必要なときに返す。標準では 401 に相当する。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · IIS

nginx の内部コードで、悪意のあるアクセスに対して何も返さず接続を閉じたことをログに記録するためのもの。クライアントには何も届かない。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · nginx

Microsoft の拡張で、必要な情報が足りないため補って再試行するよう促す。ほぼ社内向けの実装でしか見ない。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · IIS

Windows のペアレンタルコントロールがページを遮断したときに使われた Microsoft 独自のコード。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · Microsoft

検閲・裁判所命令・地域的な法規制によって提供を止めていることを示す。番号は『華氏 451 度』にちなむ。Link: rel="blocked-by" で誰の要求による遮断かを示せる。

4xx クライアントエラー 既定でキャッシュ可 本文あり

AWS のロードバランサーが、応答を返す前にクライアント側が接続を切ったことを記録するコード。利用者がページを閉じた・戻ったときに出るので、必ずしも異常ではない。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · AWS ELB

nginx が内部で使うコードで、標準の 431 に相当する。ログにだけ現れる。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · nginx

クライアント証明書の検証に失敗したときに nginx が記録する。相互 TLS を使っている構成で出る。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · nginx

相互 TLS が必須の構成で、クライアントが証明書を出さなかったときに nginx が記録する。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · nginx

TLS を期待しているポートに平文のリクエストが来たことを nginx が記録する。ポート設定やリバースプロキシの向き先の誤りを示す。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · nginx

Esri の ArcGIS が使う独自コード。標準では 401 に相当する。

4xx クライアントエラー キャッシュしない 本文あり 非標準 · Esri ArcGIS

nginx のログでよく見るコード。利用者が読み込み中にページを離れた場合と、上流が遅すぎて待ちきれなかった場合の両方で出る。急に増えたときは後段の遅延を疑う。

4xx クライアントエラー キャッシュしない 本文を持てない 非標準 · nginx

他のどれにも当てはまらないサーバー側の失敗をまとめて表す。利用者に見せる本文には内部の情報(例外メッセージ・スタックトレース・DB のホスト名)を出さず、ログにだけ残す。

5xx サーバーエラー キャッシュしない 本文あり

405 が「この URL では使えない」なのに対し、501 は「サーバーがそのメソッドを一切扱えない」。将来対応する見込みがあるものにも使う。

5xx サーバーエラー 既定でキャッシュ可 本文あり

リバースプロキシや CDN が、後ろのアプリケーションから正しい応答を受け取れなかった。アプリが落ちている・ポートが違う・起動途中、といった原因が多い。応答を返しているのは前段なので、調べるべきは後段のログ。

5xx サーバーエラー キャッシュしない 本文あり

メンテナンス中や過負荷で一時的に応じられない状態。Retry-After を付ければ、検索エンジンにも「今だけ」と伝わり索引から落とされにくい。メンテナンス画面は 200 ではなく 503 で返す。

実務メモ: 外形監視は「トップページが 200 か」だけでは足りない。トップがエッジにキャッシュされていると、DB が落ちていても 200 を返し続ける。DB に軽いクエリを投げるヘルスチェック用の経路を別に用意する。

5xx サーバーエラー キャッシュしない 本文あり

前段が後段の応答を待ったが、制限時間内に返ってこなかった。重いクエリ、外部 API の遅延、コネクションプールの枯渇が典型的な原因。502 は「壊れた応答が返った」、504 は「返ってこなかった」。

5xx サーバーエラー キャッシュしない 本文あり

リクエストで使われた HTTP のバージョンをサーバーが扱えない。古いクライアントや、手書きのリクエストの書式ミスで見ることがある。

5xx サーバーエラー キャッシュしない 本文あり

透過的コンテンツネゴシエーションで、選ばれた候補自体がまた候補を選ぼうとして循環している状態。サーバー設定の誤りを示す。

5xx サーバーエラー キャッシュしない 本文あり

WebDAV で、書き込みを完了するだけの空き容量がサーバーに無いときに返る。ディスク満杯やクォータ超過が原因。

5xx サーバーエラー キャッシュしない 本文あり

WebDAV のバインディングによって参照が循環し、処理が終わらないことを検出して打ち切った。208 と同じ循環構造の問題に対する、打ち切り側の応答。

5xx サーバーエラー キャッシュしない 本文あり

共有ホスティングの管理ツール(cPanel 等)が、契約の転送量上限を超えたサイトに返す非標準コード。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · cPanel

RFC 2774 の HTTP 拡張フレームワークで、要求を処理するために必要な拡張が示されていないときに返す。この枠組み自体がほとんど使われていない。

5xx サーバーエラー キャッシュしない 本文あり

公衆 Wi-Fi のログイン画面(キャプティブポータル)が本来返すべきコード。オリジンではなく途中のネットワーク機器が生成する。実際には 302 で portal に飛ばす実装が多く、これが HTTPS を壊す原因になっている。

5xx サーバーエラー キャッシュしない 本文あり

Cloudflare がオリジンから空の応答・不正なヘッダー・接続の突然の切断を受け取ったときの総称。オリジン側のクラッシュやヘッダーの重複が原因になることが多い。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

オリジンのサーバーが落ちているか、Cloudflare の IP からの接続をファイアウォールで拒否している。プロセスの死活と、許可 IP の設定の両方を確認する。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

TCP の接続そのものが時間内に確立しなかった。経路の問題、オリジンの過負荷、パケットを落とすファイアウォールが原因になる。504(応答待ちのタイムアウト)より手前の段階で失敗している。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

DNS の設定が誤っている、オリジンの IP が変わった、経路が無いなどで到達できない。DNS レコードの向き先を確認する。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

Cloudflare の待ち時間(既定 100 秒)を超えて応答が返らなかった。長時間かかる処理は非同期にして 202 を返し、進捗を別の URL で見せる形に変えるのが根本的な解決になる。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

オリジンの証明書や暗号スイートが Cloudflare の期待と合っていない。証明書の期限切れ、対応する暗号方式の不一致が典型。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

Full (Strict) モードで、オリジンの証明書が自己署名だったり期限切れだったりして検証に失敗した。Cloudflare Origin CA 証明書を入れると解決することが多い。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

530 は単独では意味を持たず、画面に併記される Error 1016 のような 1xxx 番のコードが本当の原因を示す。Workers の例外(1101)やオリジンの DNS 解決失敗(1016)でよく見る。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Cloudflare

一部のプロキシが独自に使うコードで、標準には存在しない。ネットワークの読み取り待ちが時間切れになったことを示す。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Proxies

598 と同じく非標準で、接続の確立に失敗したことを示す。HTTP クライアントライブラリが内部的なエラーを表すために使うこともある。

5xx サーバーエラー キャッシュしない 本文あり 非標準 · Proxies