本文介绍如何使用 pydantic.create_model 为继承自 BaseModel 的类（含 alias、serialization_alias 等字段配置）生成一个所有字段均为可选（Optional[T]）且完整保留原始别名语义的新模型。
本文介绍如何使用 `pydantic.create_model` 为继承自 `basemodel` 的类（含 `alias`、`serialization_alias` 等字段配置）生成一个所有字段均为可选（`optional[t]`）且完整保留原始别名语义的新模型。
在 Pydantic v2 中，若需将现有模型（如 ClientModel）的所有字段动态转为可选，并严格保留 alias、serialization_alias、validation_alias 等元数据，直接操作 __annotations__（如递归提取类型）会丢失 Field 配置信息——这正是原方案中 id 字段别名失效的根本原因：Field(alias="_id", serialization_alias="id") 未被传递，仅剩类型 str | None。
正确做法是直接复用 model_fields 中的 FieldInfo 实例，它完整封装了字段的类型、默认值、别名、验证器等全部声明式元数据。
✅ 推荐方案：基于 model_fields 构建可选模型（保留全部 Field 配置）
from pydantic import create_model, FieldInfo
from typing import Any, Optional, get_origin, get_args
import copy
# ✅ 安全复制并修改 FieldInfo，避免污染原模型
field_infos: dict[str, FieldInfo] = {}
for field_name, field_info in ClientModel.model_fields.items():
# 深拷贝确保隔离性（尤其当后续调用 model_rebuild 时）
field_info_copy = copy.deepcopy(field_info)
# 关键：显式设 default=None，使字段真正“可选”
field_info_copy.default = None
# 扩展类型为 T | None（兼容 Union / Optional 语法）
field_infos[field_name] = field_info_copy
# 构建新模型：字段名 → (新类型, FieldInfo)
OptionalClientModel = create_model(
"OptionalClientModel",
**{
name: (field_info.annotation | None, field_info)
for name, field_info in field_infos.items()
}
)
? 验证别名是否生效？
# 序列化时 id 应输出为 "id" 键，而非 "_id" obj = OptionalClientModel(id="abc123", first_name=None, last_name=None) print(obj.model_dump()) # {'id': 'abc123', 'first_name': None, 'last_name': None} print(obj.model_dump(by_alias=True)) # {'id': 'abc123', 'first_name': None, 'last_name': None} print(obj.model_dump_json(by_alias=True)) # {"id":"abc123","first_name":null,"last_name":null}
⚠️ 注意事项与最佳实践
-
勿修改原始
FieldInfo：直接赋值field_info.default = None会影响ClientModel自身行为（如ClientModel()实例化时字段可能意外变为可选）。务必使用copy.deepcopy。 -
| None是 Pydantic v2.5+ 推荐写法：等价于Optional[T]，但更简洁；若需兼容旧版本，可用Union[T, None]或Optional[T]。 -
嵌套模型/泛型字段同样适用：
model_fields中的FieldInfo.annotation已解析为运行时类型（如str,Annotated[str, BeforeValidator(...)]），| None可安全应用。 -
自定义
ConfigDict不自动继承：若需共享配置（如json_encoders），需显式传入：OptionalClientModel = create_model( "OptionalClientModel", __config__=ClientModel.model_config, # 显式继承配置 **{...} )
✅ 总结
要生成带完整别名支持的全可选模型，核心是：
✅ 使用 YourModel.model_fields 获取结构化字段元数据；
✅ 深拷贝 FieldInfo 并设置 default = None；
✅ 用 annotation | None 升级类型，配合原 FieldInfo 传入 create_model；
❌ 避免仅操作 __annotations__ 或手动拼接 Field(...) —— 这会丢失原始别名与验证逻辑。
该方法简洁、可靠，且完全符合 Pydantic v2 的设计哲学：字段即配置，类型即契约，别名即契约的一部分。
