GitHub Releases웹 · 프론트엔드오늘의 주요

fastapi/fastapi

FastAPI 0.162.0 불린 폼 필드 처리 방식 변경

원제 fastapi/fastapi 0.162.0

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 선택 시 제출된 필드로 계산되지 않는다.
  • default factories와 validate_default는 기존 규칙을 따르며, HTML 체크박스의 경우 기본값을 False로 선언해야 한다.
  • 이는 Pydantic의 동작 방식과 일관성 있게 다른 필드들의 처리 방식과 동일하게 변경된 breaking change이다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗