代表的な HTTP ステータスコードとは？200・301・302・401・403・404・500・502・503 を実務目線で整理

200 OK

もっとも一般的な成功。「リクエストが処理され、レスポンスボディも返している」 状態。Web ページ表示や 「GET の API」 で日常的に見る。

201 Created

新規リソース作成成功。POST /users で新しいユーザーを作ったときなど、REST API でリソースが作られた合図。

204 No Content

成功したがレスポンスボディなし。DELETE の成功や、変更不要な PUT 後などで使われる。「空っぽ = エラー」 と勘違いしないように。

206 Partial Content

レンジリクエスト(動画やダウンロードの一部取得)の成功。動画のシーク、ダウンロード再開などで裏で出ている。

301 Moved Permanently

恒久的にリダイレクト。http://example.com → https://example.com のような 恒久的な引っ越し で使う。SEO 上もこちらが推奨。

302 Found(旧: Moved Temporarily)

一時的なリダイレクト。「ログインしていないと /login へ飛ばす」 「メンテ中はメンテページへ」 のような 状況依存 な遷移。

303 See Other

「POST 後に GET でこのページを開いて」という指示。フォーム送信後のリロード対策(「PRG パターン」)で使われる。

304 Not Modified

キャッシュが有効なので、リソースは再送しない。ブラウザのキャッシュ判定で頻発。「成功」 の一種として扱える。

307 / 308

307 は 「302 と同じだがメソッド維持」、308 は 「301 と同じだがメソッド維持」。「POST が GET に変換されてはまずい」 場面で使う厳密版。

400 Bad Request

リクエスト内容が不正。JSON が壊れている、必須パラメータが足りない、型が違うなど。API では 「バリデーション NG」 の代表選手。

401 Unauthorized(認証)

「本人確認に失敗」 状態。ログインしていない、トークンが期限切れ、ヘッダの認証情報が不正など。ログインしてください の合図。

403 Forbidden(認可)

「認証は OK だが、その操作を行う権限がない」 状態。一般ユーザーが管理ページを開いた、他人の投稿を編集しようとした、IP 制限に引っかかった等。

404 Not Found

その URL に対応するリソースが見つからない。記事削除済み、ルーティング設定漏れ、タイポが原因のことが多い。

405 Method Not Allowed

URL は存在するが、そのメソッド(GET / POST / PUT 等)が許可されていない。CORS 設定漏れや API ルーティング設定で出やすい。

408 Request Timeout

クライアントが期間内にリクエストを送り終えなかった。大きなファイルのアップロード時などで稀に出る。

409 Conflict

状態の競合。同じリソースに同時編集、ユニーク制約違反、git でいう conflict 的な状態。「楽観的ロック」 の API で頻出。

413 Content Too Large(旧称 Payload Too Large)

送られてきた本文が大きすぎる。画像アップロード API でファイルサイズ上限を超えるケースなど。

415 Unsupported Media Type

「Content-Type が想定外」。application/json を期待しているのに multipart/form-data で送ってきた、など。

422 Unprocessable Content(旧称 Unprocessable Entity)

形式は正しいが意味的に処理できない。Laravel などのフレームワークで 「バリデーション失敗時に 422」 を返すのが流儀になっている。

429 Too Many Requests

レートリミットに引っかかった。「API を叩きすぎ」 「WAF / CDN がボット判定」 などで出る。Retry-After ヘッダ を見て待つのが基本対応。

500 Internal Server Error

アプリケーションが落ちた・例外が握りつぶされた、というケースの代表。内部のエラー、原因はサーバログを見るしかない のが基本姿勢。

501 Not Implemented

「 その機能はまだ実装していません」 系。実務で出てくる頻度は低い。

502 Bad Gateway

リバプロや CDN が上流(アプリ / API)から不正な応答を受け取った。リバプロ ↔ アプリの間でアプリが落ちている の典型サイン。

503 Service Unavailable

サーバが一時的に応答できない。メンテナンス中、過負荷、起動直後の初期化中など。Retry-After を見て少し待つのが基本対応。

504 Gateway Timeout

リバプロや CDN が上流からの応答を待ちきれずタイムアウト。アプリの処理が遅い / 上流API が応答返さない / ネットワークが詰まっている ときに出る。

521 / 522 / 523 など Cloudflare 拡張

Cloudflare などの CDN が独自に定義する 「オリジン到達失敗」 系。「本物のサーバが返したコードではない」 ことを見落とさない。

①4xx のはずなのに 200 を返すアプリ

「ステータスは 200、ボディに {error: '...'}」 のような実装。クライアント側の例外処理が 「ステータスコードしか見ない」 場合、エラーを見落とす。正しい 4xx を返す のが API の良い設計。

②5xx をクライアントのせいだと思い込む

「これブラウザ側のキャッシュかな」 と粘ったら、実はサーバが落ちていた、というパターン。5xx を見たら、まずサーバを見る のが鉄則。

③ 404 と 410 の使い分け漏れ

「削除済みなのに 404」 だけ返す実装が多い。SEO 観点では 「恒久的に消した」 ものは 410 Gone を返したほうが Google の認識が早い。

④ リダイレクトループ

301 や 302 が無限に続いている状態。ブラウザは Too many redirects で止まる。「HTTPS 化設定の重複」 「ログイン状態の判定ミス」 で起きやすい。