Pydantic BaseModel 默认拒绝多余字段，可通过 model_config = {"extra": "allow"} 允许、{"extra": "ignore"} 忽略或 {"extra": "forbid"} 严格禁止；Tortoise-ORM 用 pydantic_model_creator 的 exclude/include 控制字段；SQLAlchemy 异步需预加载或清理 __dict__ 避免延迟加载问题；FastAPI 的 response_model 必须是 Pydantic 模型而非 ORM 类。
Pydantic BaseModel 默认拒绝多余字段，怎么关掉？
默认情况下，BaseModel 会严格校验输入数据，遇到模型里没定义的字段就直接报错：ValidationError: Extra inputs are not permitted。这在接收前端传参、或对接外部系统时特别容易踩坑。
解决方式很简单：在模型内部用 model_config 控制行为：
- 允许多余字段（推荐用于请求体接收）：
model_config = {"extra": "allow"} - 忽略多余字段（更安全，常用）：
model_config = {"extra": "ignore"} - 完全禁止（默认行为）：
model_config = {"extra": "forbid"}
示例：
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
from pydantic import BaseModel
<p>class UserCreate(BaseModel):
username: str
email: str
model_config = {"extra": "ignore"} # 多余字段如 "age": 25 不报错也不存入实例
注意：extra="ignore" 只影响初始化时的字段过滤，不会自动把多余字段塞进实例属性里——它真就“视而不见”。
Tortoise-ORM 模型怎么转成 Pydantic 模型且忽略 ORM 字段？
Tortoise-ORM 提供了 pydantic_model_creator，但它默认会把所有字段（包括 id、created_at 等 ORM 元字段）都塞进去，而你往往只想暴露业务字段，或者想排除某些敏感/计算字段。
关键参数是 exclude 和 include：
-
exclude=("id", "password_hash")—— 明确排除字段 -
include=("username", "email")—— 只保留指定字段 - 支持嵌套关系字段，比如
exclude=("blogs__title",)
示例：
from tortoise.contrib.pydantic import pydantic_model_creator
from app.models import User
<p>UserOut = pydantic_model_creator(
User,
name="UserOut",
exclude=("password_hash", "is_active"),
)
这样生成的 UserOut 就不会带 password_hash，也不会在 OpenAPI 文档里暴露它——比手动写 BaseModel 更省事，也更可靠。
SQLAlchemy 异步模型怎么映射到 Pydantic 且跳过未加载字段？
SQLAlchemy 的异步模式下，AsyncSession.get() 返回的是延迟加载对象，有些关联字段（比如 user.profile）可能根本没查出来。如果直接用 BaseModel.from_orm(user)，就会触发 AttributeError 或隐式 SQL 查询（破坏异步语义）。
必须显式控制字段加载和转换逻辑：
- 查询时用
selectinload或joinedload预加载所需关系 - 转换前检查字段是否存在：
if hasattr(user, "profile") - 更稳妥的做法：不用
from_orm，改用字典构造：UserOut(**user.__dict__)，但要注意__dict__里可能含 SQLAlchemy 内部属性（如_sa_instance_state），得先清理
推荐做法是封装一个 clean dict 工具函数：
def orm_to_dict(obj):
d = {k: v for k, v in obj.__dict__.items() if not k.startswith("_")}
return {k: v for k, v in d.items() if v is not None or k in ("id", "username")} # 按需调整
为什么不能直接用 response_model=User？
因为 User 是 ORM 类，不是 Pydantic 模型。FastAPI 的 response_model 参数只接受 BaseModel 子类。如果你硬写 response_model=User，运行时不会报错，但序列化会失败，返回空对象或 500 错误，日志里只有模糊的 TypeError: Object of type User is not JSON serializable。
真正要做的，是明确区分三层：
- ORM 模型（
User）：负责数据库映射与操作 - Pydantic 输入模型（
UserCreate）：验证请求体 - Pydantic 输出模型（
UserOut）：定义响应结构
漏掉任何一层，都容易在字段控制、类型转换、文档生成上出问题。尤其 exclude 这种配置，必须落在 Pydantic 模型上才生效，ORM 层的 exclude（比如 Tortoise 的 Meta.exclude）对 FastAPI 序列化毫无作用。
