FastAPI中PUT请求仅传更新数据的Pydantic验证及参数疑问

问题1：URL已包含item_id时，如何让请求体无需传入id字段？ #

FastAPI里可以通过PartialType工具实现类似NestJS的效果，既让所有更新字段可选，又排除掉不需要的id字段。具体做法如下：

from fastapi import FastAPI, PartialType
from pydantic import BaseModel, Union

app = FastAPI()

class Item(BaseModel):
    id: str
    description: str = "default description"
    price: Union[float, None] = None
    tax: float = 10.5
    tags: list[str] = []

# 生成更新专用模型：排除id字段，且所有属性变为可选
UpdateItem = PartialType(Item, exclude={"id"})

@app.put("/items/{item_id}")
async def update_item(item_id: str, item: UpdateItem):
    # 仅提取请求中实际传入的字段（忽略默认值）
    updated_fields = item.model_dump(exclude_unset=True)
    # 后续可结合item_id和updated_fields完成数据库更新等逻辑
    return {"item_id": item_id, "updated_fields": updated_fields}

这样请求体不需要包含id字段，同时所有更新字段都是可选的，完全适配PUT请求的部分更新场景。你也可以手动定义UpdateItem模型（去掉id字段并将所有属性标记为可选），但PartialType能更高效地复用原模型逻辑。

问题2：不指定item类型时，为何会变成必填查询参数？ #

这是FastAPI的参数解析规则决定的：

• 如果函数参数没有指定类型，也没有用Body()/Query()等装饰器显式声明来源，FastAPI会默认将其识别为查询参数。
• 对于PUT/POST这类带请求体的请求，要让参数来自请求体，必须满足两个条件之一：要么参数是Pydantic模型类型，要么用Body()装饰器明确标记。

如果不想用Pydantic模型，也可以这样显式指定item来自请求体：

from fastapi import Body

@app.put("/items/{item_id}")
async def update_item(item_id: str, item: dict = Body(...)):
    pass

但更推荐用Pydantic模型，既能自动完成数据验证，还能自动生成接口文档。

和NestJS的对比 #

FastAPI的PartialType和NestJS的PartialType()作用完全一致，都是基于原DTO生成所有属性可选的更新模型，避免重复编写代码。两者的核心思路都是通过工具类复用基础模型，适配不同的请求场景。

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