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

fastapi/fastapi

FastAPI 0.151.0, JSON null 값 처리 방식 변경

원제 fastapi/fastapi 0.151.0

0.151.0
Key Point

FastAPI의 요청 검증 동작이 명확해져 명시적 null 처리가 더 엄격해졌으므로, 기존 클라이언트의 동작을 확인하고 필요시 수정해야 한다.

핵심 요약

  • FastAPI 0.151.0에서 JSON 요청 본문의 null 값과 생략된 값을 구분하기 시작했다.
  • 개별 Body 파라미터에서 null은 None으로 검증되며, nullable 타입은 이를 수용하고 non-nullable 타입은 기본값이 정의되어 있어도 거부한다.
  • 기본값과 기본값 팩토리는 값이 생략되었을 때만 적용되며, 이는 JSON 객체 내부의 파라미터와 전체 본문을 나타내는 파라미터 모두에 적용된다.
  • Body(embed=True)를 사용하거나 여러 body 파라미터가 있을 때 전체 본문으로 null을 전송하면 검증 오류가 반환된다.
  • 이는 주요 변경사항으로, 이전에 null을 전송해서 기본값을 요청하던 클라이언트는 값을 생략하도록 변경해야 한다.
AI 요약 안내

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

요약 원칙 ↗