Python pickle 怎样处理私有方法序列化

Python 3.15 增加了 pickle 对私有方法的支持，但使用时仍要区分“绑定到实例的方法对象”和“类中的代码定义”。普通私有绑定方法可以作为新版本下的尝试对象；能否恢复，还取决于所属类可被找到、实例状态可序列化，以及恢复环境与写入环境是否兼容。

官方文档：https://docs.python.org/3.15/library/pickle.html。只加载自己信任且未被篡改的 pickle 数据；不可信数据可能在反序列化时执行代码。下面仅使用当前程序刚生成的内存字节，不接收上传文件。

先确认保存的是方法还是实例

排查前先写清传给 dumps 的对象。保存普通实例，通常是在保存实例状态；保存 obj.callback() 的返回值时，如果返回的是 self.__adjust，才是在保存一个私有绑定方法对象。名字相似，不代表走的是同一种对象恢复路径。

双下划线名称涉及名称改写。CPython 的历史问题记录明确涉及私有名称在往返恢复中的查找差异；不要把“dumps 已经返回字节”当成 loads 和后续调用必然成功的证据。也不要把普通私有绑定方法的示例直接推广到装饰器包装、私有静态方法或任意局部闭包。

Python 3.15 中做一次可信数据往返

把类放在可导入的 adjustment_model.py 模块中，让演示脚本负责往返。这样可以避免把笔记本单元格或临时局部定义当成部署后的模块布局。

# adjustment_model.py：类定义位于可导入模块的顶层
class Adjustment:
    def __init__(self, offset):
        self.offset = offset

    def __adjust(self, number):
        # 仅依赖简单实例状态，不持有文件或连接
        return number + self.offset

    def callback(self):
        # 返回绑定方法，不在这里执行计算
        return self.__adjust

# roundtrip_demo.py：仅加载本进程刚生成的可信数据
import pickle
import sys
from adjustment_model import Adjustment

if sys.version_info 

这里保存的是 callback 返回的私有绑定方法，而不是 callback 本身，也不是私有方法的计算结果。恢复后关联的是还原的实例，不应把它与原对象的身份相等混为一谈。上面断言供读者在目标环境执行，本文没有运行或展示伪造输出。

protocol=5 是示例的显式协议选择，不是打开私有方法支持的开关。协议号与解释器新增的对象支持能力要分别理解。

按模块、类和实例状态逐层排查

首先确认写入端与读取端的 Python 版本，而非只看本地开发机。其次确认 adjustment_model 模块在读取环境中可导入，类名和布局没有被重命名；再检查实例引用的状态是否包含不能序列化的资源。最后才看私有方法名及包装层是否改变了恢复所需的对象关系。

pickle 不是把类或函数的实现完整封装进字节流。依赖代码仍在读取环境中，所以更新代码后，同一份数据可能面对新的行为。对于恢复错误，保留异常类型、出错阶段和环境信息，不要把所有错误笼统归成“私有方法不支持”。

示例特意只持有 offset。若真实对象里还有活动文件、数据库会话或线程锁，不能因为私有方法名称已被支持，就推导这些状态也一定能恢复。异常应由业务错误处理路径报告，不要捕获后返回空回调，让错误延迟到任务执行时才暴露。

长期任务改存显式数据更容易维护

如果任务需要跨部署长期保存，建议先考虑显式保存业务参数，再由稳定的公开入口执行。以下数据描述示例任务，而不是记录私有方法名；这是一种应用设计取舍，不是 pickle 自动完成的迁移机制。

# 任务采用应用自定义的版本和类型，不从数据动态导入方法
task = {"schema": 1, "kind": "adjustment", "offset": 7, "number": 10}

def execute_task(item):
    # 明确白名单及参数范围；这里只示范一个受限计算任务
    if item.get("schema") != 1 or item.get("kind") != "adjustment":
        raise ValueError("不支持的任务版本或类型")
    offset = item.get("offset")
    number = item.get("number")
    if type(offset) is not int or type(number) is not int:
        raise ValueError("参数必须为整数")
    if abs(offset) > 1000000 or abs(number) > 1000000:
        raise ValueError("参数超出示例范围")
    return number + offset

这样类内部重命名私有方法时，不必把持久化格式也绑定到该名称。若使用 JSON 等数据格式传输，还需在应用层继续约束大小、类型与业务含义，不能把更换格式当成全部输入问题的解决方案。

用兼容性清单决定是否采用

仅把私有方法改成单下划线，是不是就解决了兼容性？没有，模块依赖和状态问题仍然存在。选择更高协议号能替代升级解释器吗？不能据此作保证。新版本写入后能否直接交给旧版本读取？应按实际对象、协议和代码布局确认，不能从一次同进程往返推广为跨版本承诺。

参考：Python 3.15 pickle 变更；pickle 对象恢复与可信数据要求；CPython 私有名称往返问题记录。