FastAPI 0.162.0 불린 폼 필드 처리 방식 변경
Key Point
FastAPI의 불린 폼 필드 처리가 Pydantic 표준에 맞춰 변경되면서, 기존에 omitted 불린을 False로 자동 처리하던 코드가 동작을 멈출 수 있으므로 업그레이드 전 영향 범위를 파악해야 한다.
핵심 요약
- FastAPI 0.162.0에서 omitted된 bool과 bool | None 폼 필드가 더 이상 False로 자동 추론되지 않으며, 선언된 기본값을 사용하거나 누락 필드 오류를 발생시킨다.
- 이 변경은 개별 폼 파라미터, 폼 모델, 폼 모델의 union을 포함한 모든 boolean 필드에 적용된다.
- omitted된 boolean 모델 필드는 model_dump(exclude_unset=True)에서 제외되며, 기본값이 union 선택 시 제출된 필드로 계산되지 않는다.
릴리스 노트 보기 ↗github.com