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을 전송해서 기본값을 요청하던 클라이언트는 값을 생략하도록 변경해야 한다.
릴리스 노트 보기 ↗github.com