0

0

Pydantic 中自定义对象作为默认参数时未自动深拷贝的解决方案

聖光之護

聖光之護

发布时间:2026-02-26 23:13:00

|

651人浏览过

|

来源于php中文网

原创

Pydantic 中自定义对象作为默认参数时未自动深拷贝的解决方案

Pydantic 仅对不可哈希(unhashable)类型的默认值执行实例级深拷贝,而用户自定义类默认是可哈希的,因此 Spam() 这类对象会被共享;正确做法是改用 Field(default_factory=...) 确保每次实例化都生成独立副本。

pydantic 仅对**不可哈希(unhashable)类型**的默认值执行实例级深拷贝,而用户自定义类默认是可哈希的,因此 `spam()` 这类对象会被共享;正确做法是改用 `field(default_factory=...)` 确保每次实例化都生成独立副本。

在 Pydantic 模型中,为字段指定默认值时,若该值是可变对象(如 list, dict, 或自定义类实例),开发者常期望每次创建新模型实例时,该字段都获得一个独立的副本,避免状态意外共享。Pydantic 确实为此提供了保障——但有一个关键前提:它仅对不可哈希(unhashable)对象自动触发深拷贝。

Python 规定:所有用户自定义类的实例默认是可哈希的(只要未显式定义 __hash__ = None 或实现冲突的 __eq__/__hash__),而 Pydantic 的深拷贝机制正是依据 hash() 是否抛出 TypeError 来判断是否需要深拷贝。这意味着:

  • ✅ list = []、dict = {} 等内置可变类型不可哈希 → Pydantic 自动深拷贝 → 每个实例拥有独立列表;
  • ❌ Spam() 实例默认可哈希 → Pydantic 跳过深拷贝 → 所有实例共享同一对象引用。

这解释了原代码中 obj1.item.names.append("bye") 同时影响 obj2.item.names 的现象,以及 id(obj1.item) == id(obj2.item) 返回 True 的原因——它们指向同一个 Spam 实例。

简单AI
简单AI

搜狐推出的AI图片生成社区

下载

正确解法:使用 default_factory

应弃用直接赋值的默认参数(item: Spam = Spam()),改用 Field(default_factory=...),由 Pydantic 在每次实例化时惰性调用工厂函数,确保对象严格隔离:

from pydantic import BaseModel, ConfigDict, Field

class Spam:
    def __init__(self) -> None:
        self.names = ["hi"]

class Person(BaseModel):
    model_config = ConfigDict(arbitrary_types_allowed=True)

    item: Spam = Field(default_factory=Spam)  # ✅ 每次新建 Person 都调用 Spam()
    lst: list = []  # ✅ list 默认仍被深拷贝(因不可哈希)

运行效果验证:

obj1 = Person()
obj2 = Person()

obj1.lst.append(10)
obj1.item.names.append("bye")

print(obj1.lst)        # [10]
print(obj1.item.names) # ['hi', 'bye']
print(obj2.lst)        # []
print(obj2.item.names) # ['hi'] ← 独立副本!
print(id(obj1.item) == id(obj2.item))  # False

注意事项与最佳实践

  • ⚠️ 不要依赖 __deepcopy__:即使你实现了 __deepcopy__,只要对象可哈希,Pydantic 就不会调用它。该方法仅在对象被判定为需深拷贝时才生效。
  • ⚠️ 避免可变默认参数陷阱:item: Spam = Spam() 是典型的“危险默认值”写法,在 Pydantic 和纯 Python 函数中均应规避。
  • 优先使用 default_factory:对任意可变对象(包括自定义类、嵌套结构、带初始化逻辑的对象),Field(default_factory=...) 是最清晰、最可靠的方式。
  • ? 若需深度定制拷贝行为:可在 Spam 中保留 __deepcopy__,但必须配合 default_factory 使用,此时它会在 Spam 被其他支持深拷贝的上下文(如手动 deepcopy())调用,而非由 Pydantic 主动触发。

综上,Pydantic 的深拷贝策略是务实且符合 Python 类型哲学的:它不强行干预可哈希对象的语义,而是将控制权交还给开发者——通过 default_factory 显式声明“此处需新实例”,从而兼顾性能、安全与可预测性。

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
append用法
append用法

append是一个常用的命令行工具,用于将一个文件的内容追加到另一个文件的末尾。想了解更多append用法相关内容,可以阅读本专题下面的文章。

348

2023.10.25

python中append的用法
python中append的用法

在Python中,append()是列表对象的一个方法,用于向列表末尾添加一个元素。想了解更多append的更多内容,可以阅读本专题下面的文章。

1080

2023.11.14

python中append的含义
python中append的含义

本专题整合了python中append的相关内容,阅读专题下面的文章了解更多详细内容。

178

2025.09.12

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

331

2026.02.25

Steam官网正版入口与注册登录指南_新手快速进入游戏平台方法
Steam官网正版入口与注册登录指南_新手快速进入游戏平台方法

本专题系统整理Steam官网最新可用入口,涵盖网页版登录地址、新用户注册流程、账号登录方法及官方游戏商店访问说明,帮助新手玩家快速进入Steam平台,完成注册登录并管理个人游戏库。

49

2026.02.25

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

33

2026.02.25

Python数据处理流水线与ETL工程实战
Python数据处理流水线与ETL工程实战

本专题聚焦 Python 在数据工程场景下的实际应用,系统讲解 ETL 流程设计、数据抽取与清洗、批处理与增量处理方案,以及数据质量校验与异常处理机制。通过构建完整的数据处理流水线案例,帮助开发者掌握数据工程中的性能优化思路与工程化规范,为后续数据分析与机器学习提供稳定可靠的数据基础。

13

2026.02.25

Java领域驱动设计(DDD)与复杂业务建模实战
Java领域驱动设计(DDD)与复杂业务建模实战

本专题围绕 Java 在复杂业务系统中的建模与架构设计展开,深入讲解领域驱动设计(DDD)的核心思想与落地实践。内容涵盖领域划分、聚合根设计、限界上下文、领域事件、贫血模型与充血模型对比,并结合实际业务案例,讲解如何在 Spring 体系中实现可演进的领域模型架构,帮助开发者应对复杂业务带来的系统演化挑战。

5

2026.02.25

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

19

2026.02.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号