HTTP 422 Unprocessable Entity とは?

HTTP 422 Unprocessable Entity の解説と、CI/CD やデプロイで見かけたときの意味。

HTTP 422 は、構文は正しいがコンテンツが意味的なバリデーションに失敗したことを意味します。

意味するところ

422 は 400 とは異なります。JSON は正しくパースされるものの、あるフィールドがルールに違反しています(必須値の欠落、範囲外、フォーマット誤り)。API はバリデーションの詳細をボディで返します。

CI/CD で見かけるとき

CI では、API テストからの 422 は、payload が構造的には正しいが意味的に誤っていることを意味します。どのフィールドが失敗したかをエラーボディで確認してください。

重要なポイント

• 422 はバリデーションに失敗したことを意味する。
• 構文は問題なく、値が不正。
• フィールド単位のエラーはボディを読む。

関連ガイド