FastAPI为何允许查询参数必填字段传空值却拒绝Body参数？

核心差异：查询参数与Body参数的解析校验逻辑不同 #

结合你使用的FastAPI 0.95.0、Pydantic 1.10.7版本，两种参数场景的行为差异源于以下具体逻辑：

1. 查询参数场景（test_field: str = Query(...)）

• 当发起POST /api/v1/test_api?test_field=请求时，HTTP查询参数中明确存在test_field字段，其值会被FastAPI解析为空字符串""。
• Pydantic 1.x中，标记为必填（...）的str类型字段仅要求字段存在，空字符串属于合法的str实例，因此会通过校验，API返回200 OK。
• 只有完全不传递test_field查询参数时，才会触发“必填字段缺失”的校验错误。

2. Body参数场景（test_field: str = Body(...)）

• 你遇到的“传空值被拒绝”，大概率是误将未在请求体中包含test_field字段当成了“传空值”（比如仅传递{}作为JSON体，或form-data中未添加该字段）。此时Pydantic会判定字段缺失，触发必填校验错误。
• 若你确实在请求体中传递了test_field: ""（比如JSON体{"test_field": ""}或form-data的test_field=），逻辑和查询参数一致，会通过校验返回200。
• 另外，如果curl请求传递的是test_field: null（JSON格式），Pydantic 1.x会直接报错——因为str字段不允许接收None类型值，这也会被误认为是“传空值被拒绝”。

补充说明 #

上述行为是Pydantic 1.x的默认规则，若需要严格禁止空字符串，可以通过Query(..., min_length=1)或Body(..., min_length=1)添加额外校验规则。

内容的提问来源于stack exchange，提问作者QCoder