422 Unprocessable Content 表示伺服器理解內容類型,要求語法也正確,但無法處理其中包含的指示。例如 JSON 主體可以正常解析,但電子郵件欄位無效,或必填的值超出範圍。
這個狀態碼由 WebDAV(RFC 4918)以「Unprocessable Entity」之名引入,RFC 9110 則以新名稱將它納入核心 HTTP。許多網頁框架與 API(例如 Ruby on Rails 和 Laravel)會用它表示驗證錯誤,並在回應主體中傳回各欄位的錯誤訊息。
請一致地使用 400 與 422:無法解析的要求使用 400,可以解析但驗證失敗的要求使用 422。
回應範例
HTTP
HTTP/1.1 422 Unprocessable Content
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: application/json
Content-Length: 77
{"message":"Validation failed","errors":[{"field":"email","code":"invalid"}]} SEO 與重新導向檢查
422 是用於 API 和表單處理的狀態碼。爬蟲使用 GET,不應該看到它;對 GET 回傳 422 的網頁會被當成 4xx 錯誤處理,不會編入索引。
常見原因與使用情境
- 表單送出或 API 呼叫未通過驗證:缺少欄位、電子郵件地址無效,或使用者名稱已被使用。
- 文件是有效的 JSON,但不符合 API 的結構描述(schema)。
- WebDAV 的
PROPPATCH或LOCK主體是格式正確的 XML,但語意有誤。