直接pickle含threading.Lock的对象会失败，因其依赖操作系统原语而不可序列化；需通过__getstate__和__setstate__手动剔除锁并重建。

如何在python中安全地对包含锁对象的类进行序列化

为什么直接 pickle 含 `threading.Lock` 的对象会失败

因为 threading.Lock 是不可序列化的——它底层依赖操作系统原语（如 pthread mutex），内部状态无法被 Python 的 pickle 模块捕获。尝试直接 pickle.dumps() 一个带 Lock 实例的类，会抛出 TypeError: cannot pickle '_thread.lock' object。

这不是编码问题，而是设计限制：锁本身不具备跨进程/跨时间点“重建”的语义。所以安全序列化的前提，是明确「哪些状态必须保留」「哪些必须丢弃或重置」。

用 `getstate` 和 `setstate` 手动控制序列化字段

这是最常用也最可控的方式。你主动告诉 pickle：忽略锁，只序列化业务数据。

在类中定义 __getstate__(self)，返回一个字典，**不包含** Lock 类型的属性（比如 self._lock）
定义 __setstate__(self, state)，把 state 中的数据恢复到实例，并**重新初始化锁**（不能复用旧锁）
注意：如果锁是通过 property 或延迟初始化（self._lock = None），也要在 __setstate__ 中补全初始化逻辑

示例：

import threading
import pickle
<p>class Counter:
def <strong>init</strong>(self):
self.value = 0
self._lock = threading.Lock()</p><pre class="brush:php;toolbar:false;">def __getstate__(self):
    # 复制当前 __dict__，但剔除锁
    state = self.__dict__.copy()
    del state['_lock']
    return state

def __setstate__(self, state):
    # 恢复数据
    self.__dict__.update(state)
    # 重建锁（必须！）
    self._lock = threading.Lock()

安全序列化

c = Counter() c.value = 42 data = pickle.dumps(c) # ✅ 不再报错 restored = pickle.loads(data) assert restored.value == 42 assert isinstance(restored._lock, threading.Lock)