용어 사전 coding 용어 페이지

422 Unprocessable Entity

요청은 도착했지만 내용 검증에 실패했을 때의 422 상태 코드

unprocessable-entity #fastapi#api#validation

English version

다른 이름

422422 responseunprocessable entity

관련 개념

요청 본문 스키마 강제

핵심 아이디어

422 Unprocessable Entity는 요청 형식 자체는 정상적으로 읽었지만, 필수 필드 누락이나 타입 오류처럼 내용이 검증을 통과하지 못했을 때 반환하는 상태 코드입니다.

중요한 점은 서버가 요청을 "이해 못한 것"이 아니라, 이해는 했지만 규칙에 맞지 않아 처리하지 않았다는 뜻이라는 점입니다. 그래서 422는 검증 규칙이 실제로 작동하는지 보여 주는 대표 신호가 됩니다.

이 블로그에서의 역할

Mathbong의 FastAPI 시리즈에서는 경로/쿼리 파라미터 검증, 요청 본문 검증을 설명할 때 422 응답을 반복해서 확인합니다. 검증 실패를 읽는 기본 문해력에 해당하는 용어입니다.

이 개념을 다루는 글

[FastAPI 시리즈 4편] 요청 본문과 Pydantic 모델 다루기 JSON 본문으로 데이터를 받고 Pydantic 모델로 검증하는 기본 흐름을 실습하며 정리합니다.[FastAPI 시리즈 3편] 경로 파라미터와 쿼리 파라미터 구분하기 경로(path)와 쿼리(query) 파라미터를 FastAPI에서 어떻게 선언하고 검증하는지, uv 기반 개발 서버로 실습하며 정리합니다.[FastAPI Series 3] Separate Path and Query Parameters Shows how to declare path vs. query parameters in FastAPI, validate them, and practice the flow in Swagger UI.