本文介绍在 Pydantic v2 中，如何基于现有模型（含 alias、serialization_alias 等配置）动态生成一个所有字段均为可选且完整保留别名语义的新模型，避免手动重定义或丢失 _id → id 等关键序列化映射。
本文介绍在 pydantic v2 中，如何基于现有模型（含 `alias`、`serialization_alias` 等配置）动态生成一个**所有字段均为可选且完整保留别名语义**的新模型，避免手动重定义或丢失 `_id` → `id` 等关键序列化映射。
在构建 API 响应或数据库更新 DTO 时，常需一个“全可选”版本的模型（例如用于 PATCH 请求），但直接使用 create_model 并简单追加 Optional[...] 会丢失原始字段的元数据（如 alias="_id"、serialization_alias="id"、default=None 等），导致序列化/反序列化行为异常——典型表现为 id 字段在 JSON 中仍以 _id 形式出现，而非预期的 id。
正确做法是：复用原始模型的 model_fields 中完整的 FieldInfo 对象，仅将其类型扩展为 T | None，并显式设置 default=None（因 Field(...) 默认不允许缺失，而 None 是可选字段的合理默认值）。
以下是推荐实现（兼容 Pydantic v2.6+，安全可靠）：
import copy
from typing import Any, Optional
from pydantic import create_model, BaseModel, FieldInfo
def make_all_optional(model: type[BaseModel]) -> type[BaseModel]:
"""
基于输入模型，创建一个所有字段均为可选、且完全继承 alias/serialization_alias/default 等配置的新模型。
"""
field_definitions: dict[str, tuple[Any, FieldInfo]] = {}
for field_name, field_info in model.model_fields.items():
# 深拷贝 FieldInfo，避免污染原模型（尤其当后续调用 model_rebuild 时）
new_field_info = copy.deepcopy(field_info)
# 显式设为 None，确保字段可省略；若原字段已有 default（如 default=None），此步可选但更明确
new_field_info.default = None
# 扩展类型为 T | None（Python 3.10+ 语法），兼容旧版可改用 Optional[T]
annotated_type = field_info.annotation | None
field_definitions[field_name] = (annotated_type, new_field_info)
return create_model(
f"Optional{model.__name__}",
**field_definitions,
__base__=model.__base__, # 继承相同基类（如保持 ConfigDict）
)
# 使用示例
OptionalClientModel = make_all_optional(ClientModel)
✅ 效果验证：
-
OptionalClientModel.model_json_schema()中，id字段仍显示"alias": "_id"和"serialization_alias": "id"； - 序列化时
OptionalClientModel(id="abc123").model_dump()输出{"id": "abc123"}（非{"_id": "abc123"}）； - 反序列化时支持
{"id": "abc123"}或{}（全空），均能成功实例化。
⚠️ 注意事项：
- 必须使用
copy.deepcopy复制FieldInfo，否则修改default可能意外影响原始模型（尤其在热重载或多次model_rebuild场景下）； - 若模型含泛型（如
List[Item]）或复杂嵌套，该方法仍适用，因field_info.annotation已包含完整类型信息； - 不要依赖
__annotations__或自定义递归函数（如问题中get_annotations），因其无法提取Field的别名、校验器等运行时元数据。
总结：model_fields 是 Pydantic v2 提供的权威字段元数据源，结合 create_model 与 copy.deepcopy(FieldInfo)，即可零侵入地生成语义完备的可选模型——既保持接口契约，又提升代码复用性与健壮性。
