의미
요청 형식은 올바르지만 의미상 오류가 있어 서버가 처리할 수 없습니다. 예전 이름은 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용으로 정의합니다.