如何利用Python的__reduce__自定义类的序列化行为？-Python教程-PHP中文网

__reduce__ 返回值必须为2元组(callable, args)或5元组(callable, args, state, listitems, dictitems)，最常用的是前者，其中callable需为模块顶层可导入对象，args须全为可pickle类型。

如何利用python的__reduce__自定义类的序列化行为？

为什么 `reduce` 不起作用？

常见现象是：定义了 __reduce__ 但用 pickle.dumps() 序列化时行为没变，甚至抛出 TypeError: can't pickle ...。根本原因是 Python 的 pickle 协议默认优先走类的 __getstate__ / __setstate__，或者直接按默认对象结构序列化——只有当类没有自定义这些方法、且 __reduce__ 被显式调用（或协议版本 ≥ 2 且类未禁用）时才生效。更关键的是：__reduce__ 必须返回一个可调用对象（如函数或类）和其参数元组，不能只返回状态字典。

`reduce` 返回值必须满足什么结构？

它必须返回一个元组，长度为 2 或 5：

2 元组：(callable, args) —— callable(*args) 应能重建对象
5 元组：(callable, args, state, listitems, dictitems) —— 用于支持 __setstate__、列表扩展、字典更新等复合行为

最常用的是 2 元组。例如想让 MyClass(123) 序列化后只保存数字 123，反序列化时调用 MyClass.from_id(123)：

def __reduce__(self):
    return (MyClass.from_id, (self._id,))

注意：MyClass.from_id 必须是模块顶层可导入的函数/方法；self._id 必须是可 pickle 的类型（如 int、str），不能是 lambda 或嵌套闭包。

Python Testing

Python 测试速查：运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

如何安全处理不可序列化的属性（如文件句柄、线程锁）？

如果类里有 self._lock = threading.Lock() 或 self._file = open(...)，直接 pickle 会失败。此时不能靠 __reduce__ “绕过”它们，而要主动剔除——在 __reduce__ 中只传入重建所需的最小必要数据：

把资源型属性设为 None 或用 __getstate__ 过滤掉（二者选一，别混用）
确保 __reduce__ 返回的 args 不包含这些属性的值
在重建函数（如 from_id）中重新初始化资源，而不是依赖反序列化自动恢复

错误做法：return (MyClass, (self._id, self._lock)) —— _lock 不可 pickle，立刻报错。

使用 `reduce` 时最容易被忽略的兼容性点

它只影响 pickle 行为，对 json、msgpack、dill 等其他序列化库完全无效。另外，如果类继承自内置类型（如 list、dict），或用了 __slots__ 且没正确定义 __getstate__，__reduce__ 可能被忽略或引发 AttributeError。最稳妥的方式是：在定义 __reduce__ 的同时，显式实现 __getstate__ 返回空字典，并确认类没有意外覆盖 __reduce_ex__。