直接用 pickle.dump() 保存自定义类实例失败的主因是对象含不可序列化属性（如 threading.Lock、socket.socket 等），pickle 默认仅序列化 __dict__，遇不可表示为字节流的值即抛 TypeError。
为什么直接用 pickle.dump() 保存自定义类实例会失败
常见错误是对象里包含不可序列化的属性，比如 threading.Lock、socket.socket、lambda 函数或某些 C 扩展对象。此时 pickle.dump() 会抛出 TypeError: can't pickle XXX objects。
根本原因不是 pickle “不支持类”，而是它默认只序列化实例的 __dict__，遇到无法表示为字节流的值就中断。
- 检查对象是否含文件句柄、数据库连接、GUI 控件等运行时资源
- 确认类中没有动态添加的不可序列化属性（如通过
setattr(obj, 'tmp_lock', threading.Lock())） - 若使用了
__slots__，需确保所有声明字段都可序列化；否则要显式实现__getstate__
如何让带不可序列化字段的类支持 pickle
核心是接管序列化过程：用 __getstate__ 过滤掉不能存的字段，用 __setstate__ 在反序列化时重建它们。
例如一个含缓存锁和临时状态的类：
立即学习“Python免费学习笔记（深入）”；
class DataProcessor:
def __init__(self, name):
self.name = name
self.cache = {}
self._lock = threading.Lock() # 不可序列化
self._temp_flag = False # 不想持久化
<pre class="brush:php;toolbar:false;">def __getstate__(self):
state = self.__dict__.copy()
# 删除不可序列化字段
state.pop('_lock', None)
# 删除临时字段
state.pop('_temp_flag', None)
return state
def __setstate__(self, state):
self.__dict__.update(state)
# 重建锁
self._lock = threading.Lock()
# _temp_flag 不恢复，保持默认值
-
__getstate__返回的字典就是最终被 pickle 的内容，务必确保其中全是可序列化类型 -
__setstate__必须能处理字段缺失的情况（比如未来版本删了某个字段），避免KeyError - 不要在
__setstate__中调用依赖外部环境的方法（如重连数据库），反序列化应是纯数据重建
用 pickle.HIGHEST_PROTOCOL 但要注意兼容性
默认协议（0）是 ASCII 文本，体积大、慢、功能少；推荐用 pickle.HIGHEST_PROTOCOL，它自动选当前 Python 版本支持的最高协议（如 Python 3.8+ 默认是 protocol 5）。
但高协议生成的数据可能无法被旧版本 Python 读取：
- protocol 5（Python 3.8+）写入的文件，在 Python 3.7 及更早版本中会报
ValueError: unsupported pickle protocol - 如果需要跨版本共享，显式指定较低协议，如
protocol=4（兼容 3.4+） - 写入时加
mode='wb'，读取时加mode='rb'—— 二进制模式错误是静默损坏的常见原因
替代方案：什么时候不该用 pickle
pickle 不是通用数据交换格式，它绑定 Python 版本和类定义，且存在远程代码执行风险（pickle.load() 可执行任意代码）。
以下情况应换方案：
- 需要跨语言读取 → 改用
json（仅基础类型）或msgpack（支持二进制，有多种语言绑定） - 存储用户提交的数据 → 绝对禁用
pickle.load()，改用json.loads()或严格校验 schema 的pydantic解析 - 对象结构频繁变更 → pickle 没有 schema 版本管理，容易反序列化失败；考虑
dataclasses+json+ 显式迁移逻辑
真正需要 pickle 的场景其实很窄：同一套代码、同一 Python 版本、内部临时缓存。一旦涉及协作、部署或长期存储，就得主动跳出 pickle 范式。
