TechFeedTechFeed
422클라이언트 오류(4xx)

422 Unprocessable Entity — 검증 실패

요청 문법은 맞지만(400과 달리) 내용이 의미적으로 유효하지 않아 처리할 수 없다는 응답입니다. 폼·API 검증 실패에 흔히 씁니다.

언제 발생하나

필드 형식은 맞지만 비즈니스 규칙 위반(이메일 중복, 범위 초과, 필수 조합 누락) 시 발생합니다.

실무 대응

  1. 응답 body의 필드별 검증 오류 메시지를 클라이언트에 그대로 표시합니다.
  2. 서버 검증 스키마(zod·class-validator 등)의 어떤 규칙이 실패했는지 확인합니다.
  3. 400(문법 오류)과 422(의미 오류)를 구분해 일관되게 응답하면 디버깅이 쉽습니다.
💡 실무 메모: 폼 검증 실패를 400 대신 422로 응답하면 클라이언트가 "형식은 맞는데 값이 안 됨"을 구분할 수 있습니다.

관련 코드·에러

관련 가이드

AI 할루시네이션 방지 전략 — 개발자 실전 가이드Zod 스키마 검증 실전 가이드 — TypeScript 런타임 타입 안전성REST API 설계 체크리스트 2026 — 엔드포인트 네이밍부터 에러 응답까지 실무 35항목