FastAPI中能否为各端点配置同一请求模型的必填属性？

能否直接配置GenericRequestModel的必填属性？ #

不行。Pydantic 模型的字段必填性是类定义阶段就固化的静态属性，无法在单个端点使用时动态修改规则。FastAPI 完全依赖 Pydantic 做请求校验和 OpenAPI 文档生成，同一个模型的校验规则是全局统一的，没法针对不同端点做差异化配置。

适配大量端点/属性的优雅方案 #

针对50个端点+100个属性的场景，最高效的方式是基于基础模型动态生成专用请求模型，配合自定义装饰器简化代码，既保留 Pydantic 的自动校验、类型提示和文档生成能力，又不用手动编写几十上百个重复模型。

具体实现步骤 #

1. 重构基础模型

先把所有字段设为可选（默认None），用Field保留字段元信息（比如描述），方便后续复用：

# app/schemas/models.py
from uuid import UUID
from pydantic import BaseModel, Field

class GenericRequestModel(BaseModel):
    id: UUID = Field(None, description="所有端点必填的ID")
    attr1: str = Field(None, description="属性1")
    attr2: bool = Field(None, description="属性2")
    attr3: int = Field(None, description="属性3")
    # ... 剩余97个属性按此格式定义

2. 编写动态模型生成工具

利用 Pydantic 内置的create_model函数，基于基础模型快速生成指定字段为必填的新模型：

# app/schemas/utils.py
from pydantic import create_model
from app.schemas.models import GenericRequestModel

def generate_required_model(model_name: str, required_fields: list[str]):
    # 提取基础模型的字段定义
    base_fields = GenericRequestModel.model_fields
    # 构造必填字段的配置：用`...`表示必填（无默认值）
    required_defs = {
        field: (base_fields[field].annotation, ...)
        for field in required_fields
        if field in base_fields  # 避免传入不存在的字段
    }
    # 生成继承自基础模型的新模型
    return create_model(
        model_name,
        __base__=GenericRequestModel,
        **required_defs
    )

3. 自定义端点装饰器

写一个装饰器，自动为端点生成并绑定对应的必填字段模型，不用手动修改端点参数：

# app/api/decorators.py
from app.schemas.utils import generate_required_model

def with_required_fields(required_fields: list[str]):
    def decorator(endpoint):
        # 用端点名称生成唯一模型名，避免冲突
        model_name = f"{endpoint.__name__}Request"
        # 生成动态模型
        request_model = generate_required_model(model_name, required_fields)
        # 替换端点的参数注解
        endpoint.__annotations__["params"] = request_model
        return endpoint
    return decorator

4. 端点中使用装饰器

每个端点只需通过装饰器指定必填字段列表，无需手动定义模型：

# app/api/endpoints.py
from fastapi import APIRouter
from app.api.decorators import with_required_fields
from app.schemas.models import ResponseModel

router = APIRouter(prefix='/api')

@router.post('/endpoint-1')
@with_required_fields(["id", "attr1"])
def endpoint_1(params) -> ResponseModel:
    return calc_response_using_all_attrs(params)

@router.post('/endpoint-2')
@with_required_fields(["id", "attr1", "attr2"])
def endpoint_2(params) -> ResponseModel:
    return calc_response_using_attrs_1_and_2(params)

@router.post('/endpoint-3')
@with_required_fields(["id"])
def endpoint_3(params) -> ResponseModel:
    return calc_generic_response(params)

# ... 其余47个端点只需添加@with_required_fields并传入必填字段列表即可

方案优势 #

• 零重复模型代码：50个端点只需配置必填字段，不用写几十份模型定义
• 保留Pydantic全能力：自动请求校验、IDE类型提示、OpenAPI文档会正确显示每个端点的必填字段
• 维护成本极低：基础模型字段修改时，所有动态生成的模型自动同步，无需逐个调整
• 灵活性拉满：随时修改任意端点的必填字段，只需调整装饰器参数

如果部分端点需要额外的复杂校验，还可以在动态生成模型时添加model_validator或field_validator，进一步扩展校验逻辑。

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