意義
請求格式正確但含有語意錯誤,伺服器無法處理。舊稱 Unprocessable Entity。
常見原因
- 驗證失敗(電子郵件無效、缺少必填欄位)
- 違反業務規則
- Rails 或 Laravel 的驗證錯誤
解決方法
用戶端或訪客
閱讀本文中的欄位錯誤,修正後重新送出。
網站或 API 的維護者
回傳機器可讀的欄位錯誤,讓表單能標示出來。
回應範例
HTTP/1.1
HTTP/1.1 422 Unprocessable Content
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Unprocessable Content",
"status": 422,
"errors": [
{
"field": "email",
"message": "must be a valid email address"
}
]
} 規範
常見問題
› 驗證錯誤應用 400 還是 422?
許多 API 對驗證錯誤用 422,對無法解析的輸入用 400。兩者皆可,保持一致即可。
› 422 只用於 WebDAV 嗎?
它源自 WebDAV,但 RFC 9110 現在已將它定義為一般 HTTP 狀態碼。