Pydantic v2 的 BaseModel 默认不支持嵌套字典自动转模型，需显式声明子模型类型（如 user: UserDetail）、可能为 null 的字段用 Optional[T]、时间字段需符合 ISO 8601 格式并注意时区，model_dump() 需显式配置才包含计算字段和默认值。
pydantic v2 的 BaseModel 默认不支持嵌套字典自动转模型
你写好 BaseModel 子类，传入一个嵌套很深的 JSON 字典，却发现字段没被解析成子模型实例，还是原始 dict —— 这不是 bug，是默认行为。v2 要求显式声明类型注解，且子字段必须用具体模型类，不能只写 dict 或 Any。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 子结构必须定义独立的
BaseModel类，并在父模型中用该类作为字段类型（例如user: UserDetail，而非user: dict） - 避免用
Dict[str, Any]接收本应结构化的数据；它会跳过验证和转换 - 如果部分字段动态、不确定结构，用
Union[KnownModel, Dict[str, Any]]+ 自定义@field_validator控制逻辑 - 注意：
model_validate()（v2 新 API）比旧版parse_obj()更严格，不会静默忽略类型不匹配
JSON 中有 null 值，但模型字段没设 Optional
报错典型信息：Input should be a valid dictionary or object 或更隐晦的 None is not a valid input for model —— 其实就是字段声明为 str，但 JSON 里对应键的值是 null。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 所有可能为
null的字段，类型必须显式写成Optional[T]（即T | None），比如name: str | None - 别依赖默认值兜底：即使写了
name: str = "N/A"，遇到null仍会校验失败，因为null≠ 缺失字段 - 若想把
null统一转为空字符串或默认对象，用@field_validator+mode="before"预处理 - v2 中
validate_default=True不影响null处理逻辑，别误以为开了就能绕过
解析含时间戳字符串的字段，datetime 字段直接报错
JSON 里是 "created_at": "2024-03-15T14:22:08Z"，模型字段声明为 created_at: datetime，却抛出 Input should be a valid datetime —— 常见于时区信息缺失、格式不标准或字段名拼写偏差。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确保字符串符合 ISO 8601 格式（
datetime.fromisoformat()可解析的），否则加@field_validator手动解析 - 字段名别写成
created_at: Datetime（首字母大写）—— 正确是小写的datetime（来自from datetime import datetime） - 如果 JSON 时间没带时区（如
"2024-03-15T14:22:08"），pydantic 默认按本地时区解释；要统一 UTC，得在 validator 里强制.replace(tzinfo=timezone.utc) - 性能提示：大量时间字段时，避免每个都走
str → datetime解析；可预处理整个 dict 把关键时间字段提前转好再进模型
用 model_dump() 导出时，嵌套模型变成字典但丢失了自定义序列化逻辑
你在子模型里写了 @computed_field 或重载了 model_config = ConfigDict(serialize_default=True)，结果 model_dump() 出来的 JSON 没包含计算字段，或者默认值没出现。
实操建议：
立即学习“Python免费学习笔记（深入）”；
-
model_dump()默认不包含@computed_field，需显式加参数include={'my_computed_field'}或设computed=True（v2.6+） - 要导出默认值（比如字段声明为
status: str = "pending"，但实例没赋值），必须传exclude_unset=False（默认是True） - 如果用了
json_encoders（v1 风格），v2 已废弃；改用@field_serializer，且注意它只在model_dump(mode='json')或model_dump_json()中生效 - 调试技巧：先调
model.model_dump(mode='json')看是否符合预期，再决定用不用model_dump_json()
tags: list 就够了，但它其实是 list[Tag] 才触发子模型验证；一个 None、一个时区标记、一个没对齐的字段名，都可能让整个解析链静默失败或半途崩掉。 
