pytest 中 pickle.dump() 报错 “Can't pickle local object” 的根本原因是：在函数或 fixture 内部定义的类（如 test_object..TestObject）属于动态生成的局部类，无法被 pickle 正确识别和反序列化。解决方案是将类定义移至模块顶层作用域。
pytest 中 `pickle.dump()` 报错 “can't pickle local object” 的根本原因是：在函数或 fixture 内部定义的类（如 `test_object.
pickle 模块在序列化对象时，并不保存类的完整代码，而是通过模块路径 + 类名的方式记录类型信息（例如 '__main__.TestObject'）。当类在函数内部定义（即作为闭包中的 local object），Python 会为其生成类似 <locals>.TestObject</locals> 这样的非全局、不可导入的名称，导致 pickle 在后续反序列化（或仅在序列化阶段校验）时无法定位该类——即使当前测试中尚未执行反序列化，pickle.dump() 本身也会预先检查类的可持久化性，从而抛出 AttributeError。
在你的测试代码中，test_object fixture 内部定义了 TestObject 类：
@pytest.fixture
def test_object():
class TestObject(): # ❌ 错误：局部类，无法被 pickle 识别
def __init__(self, instance_file_name):
self.instance_file_name = instance_file_name
self.data = "This is a test object."
return TestObject("test_object_file")这会导致 obj_pickle(test_object, ...) 调用 pickle.dump() 时立即失败。
✅ 正确做法是将 TestObject 提升为模块级（全局）类，确保其具有稳定、可导入的全限定名：
# tests/test_persist.py
from pathlib import Path
import pytest
from lib.persist import obj_pickle
TEST_DIR = Path("test_dir")
class TestObject: # ✅ 正确：顶层定义，可被 pickle 定位
def __init__(self, instance_file_name):
self.instance_file_name = instance_file_name
self.data = "This is a test object."
@pytest.fixture
def test_object():
return TestObject("test_object_file")
def test_obj_pickle(test_object):
obj_pickle(test_object, TEST_DIR)
path = TEST_DIR / f"{test_object.instance_file_name}.pkl"
assert path.exists()⚠️ 注意事项：
- 即使你只做序列化（不反序列化），
pickle仍要求被序列化的实例所属类必须可被“导入”——即类需位于某模块的全局命名空间中，且模块可通过import语句访问； - 不要试图用
dill替代pickle来绕过此限制（虽然dill支持局部类），因为它会引入额外依赖、降低可移植性，并掩盖设计问题； - 若需测试多种对象类型，建议为每种类型定义独立的顶层测试类，或使用
@dataclass（自动具备__module__和稳定结构）； - 确保类中所有属性值本身也可被
pickle序列化（例如避免含lambda、未绑定方法、文件句柄等不可序列化对象）。
总结：pickle 的设计哲学是“显式优于隐式”，它拒绝序列化局部类正是为了保障序列化结果的可重现性与跨环境兼容性。将测试类移至模块顶层，不仅修复 pytest 报错，也使代码更清晰、更符合 Python 序列化最佳实践。
