为什么FastAPI在路由函数返回时会两次执行Pydantic构造函数？

当你在FastAPI路由中指定了response_model参数时，FastAPI会默认将路由返回的对象重新解析为对应Pydantic模型的新实例，目的是完成输出数据校验、多余字段过滤、统一输出格式的逻辑，这是框架的预期行为，并非模块Bug。你自定义的__init__方法每次构造都会重新生成secret_value，所以二次构造后返回值和原始实例不一致。

• 方案1：使用Field的default_factory参数生成默认值（最推荐）
  这种方案完全符合Pydantic的设计规范，首次构造实例时如果没有传入secret_value就会调用生成函数赋值，FastAPI二次构造时会将原有实例的secret_value作为入参传入，不会触发default_factory，值会保持一致。
  示例代码：

from pydantic import BaseModel, Field
from random import randint
from typing import Optional

class SomeModel(BaseModel):
    public_value: str
    # 只有未传值时才触发randint生成
    secret_value: Optional[int] = Field(default_factory=lambda: randint(1,5))

• 方案2：自定义__init__时加非空判断
  如果你确实需要保留自定义构造逻辑，只需在赋值前判断secret_value是否已存在，存在就不再重新生成即可：

class SomeModel(BaseModel):
    public_value: str
    secret_value: Optional[int]

    def __init__(self, **data):
        super().__init__(**data)
        # 仅当secret_value为空时才生成新值
        if self.secret_value is None:
            self.secret_value = randint(1, 5)

• 方案3：关闭response_model自动重解析（不推荐）
  如果不需要response_model的校验能力，你可以在路由装饰器中添加参数response_model_validate=False，FastAPI就不会二次构造模型实例，但会丢失输出校验、字段过滤的能力，也可能影响OpenAPI文档的准确性。

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