HTTP ステータスコード完全ガイド — 400・401・403・404・500の違いと対処法

401 Unauthorizedと403 Forbiddenの違いは何ですか？

401は「認証されていない」、403は「認証済みだが権限がない」という違いです。401は「ログインしていない or トークンが無効」で、再ログインすれば解決する可能性があります。403は「ログインしているが、そのリソースへのアクセス権がない」状態です。たとえば一般ユーザーが管理者専用ページにアクセスした場合は403が正しく、ログインしていない状態でAPIを叩いた場合は401が正しいです。混同すると「なぜ再ログインしても解決しないのか」という混乱を招くため、実装時に意識して使い分けることが重要です。

502 Bad Gatewayと503 Service Unavailableの違いは何ですか？

502は「リバースプロキシ（nginx等）の背後にあるアプリサーバーが不正なレスポンスを返した or 応答しなかった」状態です。nginxがNode.jsやPythonアプリにプロキシしようとしたが、アプリが落ちているときによく出ます。503は「サーバーが一時的にリクエストを処理できない」状態で、デプロイ中のダウンタイムやスケールアップ待ちのときに使います。どちらも「サービスが使えない」ですが、502は「バックエンドへの接続失敗」、503は「意図的or一時的なサービス停止」というニュアンスです。

404 Not Foundと410 Goneの違いは？どちらを返すべきですか？

404は「リソースが存在しない（あるかどうかわからない）」で、410は「リソースが永久に削除された（戻ってこない）」という違いです。記事を削除した場合、410を返すとGoogleなどの検索エンジンにインデックス削除を促せます。一方、404ではクローラーがしばらく再訪問を続けます。削除したコンテンツに404を返すのは技術的に誤りではありませんが、意図的に削除したことを明示したいなら410がSEO上望ましいです。多くのフレームワークはデフォルトで404を返すため、コスト対効果を考慮して使い分けてください。

422 Unprocessable Entityはいつ使いますか？

422は「リクエストの形式は正しい（JSON構文エラーなし）が、内容が処理できない」ときに使います。たとえばJSON形式は正しいが、必須フィールドがない・型が違う・バリデーション違反などが該当します。400 Bad Requestとの違いは、400が「HTTPリクエスト自体が不正（形式エラーや無効なヘッダー等）」であるのに対し、422はHTTPとしては正しいがアプリケーションレベルでのバリデーションに失敗した場合です。REST APIではバリデーションエラーに422を使うのが慣習になっています。

429 Too Many Requestsが返ってきたらどうすればいいですか？

429はレートリミット（単位時間あたりのリクエスト数制限）に達したことを意味します。対処法は3つあります。①レスポンスヘッダーの `Retry-After` または `X-RateLimit-Reset` を確認し、指定秒数後に再試行する。②指数バックオフ（1秒→2秒→4秒と待機時間を増やす）でリトライする。③APIの利用プランをアップグレードする。自分のAPIで429を実装する場合も同様に `Retry-After` ヘッダーを付けることが推奨されます（RFC 6585）。

5xxエラーが続くときの切り分け方は？

5xxエラーはサーバー側の問題ですが、原因は多岐にわたります。切り分けの手順は次のとおりです。①500なら、まずサーバーのエラーログを確認（スタックトレースが出ているはず）。②502/504ならnginx等のプロキシログとバックエンドアプリのログを両方確認。③503なら、アプリが起動しているか・ヘルスチェックエンドポイントが応答しているか確認。④タイムアウト系（504）なら、DBクエリの実行時間・外部API呼び出しのレスポンスタイムを疑う。特定のエンドポイントだけで発生するなら、そのエンドポイントのロジックに問題がある可能性が高いです。複数のエラーコードを素早く調べるには、ぱんだツールズの<Link href="/tools/error-code-search" className="text-blue-600 hover:underline">エラーコード横断検索ツール</Link>も活用できます。

301と302リダイレクトはSEOに影響しますか？

301は「恒久的なリダイレクト」でページランク（被リンクの評価）がほぼ転送されます。302は「一時的なリダイレクト」でページランクは転送されません。URL変更・ドメイン移転には必ず301を使い、Googleにリダイレクト先をインデックスさせます。302はA/Bテストやメンテナンス中の一時的な切り替えに使います。301を使うべき場面で302を使うと、古いURLにリンク評価が残り続けてSEO的に非効率です。また、HTTPからHTTPSへのリダイレクトも301で設定するのがベストプラクティスです。

REST APIで「作成成功」のステータスコードは200と201どちらが正しいですか？

POSTリクエストでリソースを新規作成した場合は201 Createdが正しいです。200 OKはリクエストが成功したことを示しますが、「何が成功したか」の意味が弱いです。201は「新しいリソースが作成された」という意味で、Locationヘッダーに作成されたリソースのURLを付けることが推奨されます。一方、PUTやPATCHで更新成功した場合は200、更新したがレスポンスボディが不要な場合は204 No Contentを返すのが一般的なREST APIの慣習です。