pytest 测试中使用 pickle 序列化失败，根本原因在于测试函数内定义的局部类（如 def test_object(): class TestObject: ...）无法被 pickle 正确识别和反序列化；解决方案是将类定义移至模块顶层作用域。
pytest 测试中使用 pickle 序列化失败，根本原因在于测试函数内定义的局部类（如 `def test_object(): class testobject: ...`）无法被 pickle 正确识别和反序列化；解决方案是将类定义移至模块顶层作用域。
在 Python 中，pickle 模块要求被序列化的对象所属的类必须具有可全局访问的、稳定的模块路径（即 module.ClassName 形式），以便反序列化时能准确重建该类。而当类在函数（如 pytest fixture）内部定义时，它成为一个局部嵌套类（local object），每次调用函数都会生成一个全新且匿名的类对象，其 __qualname__ 和 __module__ 信息不满足 pickle 的可重现性要求——因此抛出 AttributeError: Can't pickle local object 'test_object.<locals>.TestObject'</locals>。
✅ 正确做法：将测试类定义提升至模块顶层
修改 tests/test_persist.py，将 TestObject 类移出 test_object fixture，置于文件顶部：
# 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_name):
self.instance_name = instance_name # 注意：原代码中使用的是 instance_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_name}.pkl"
assert path.exists()同时，请注意 lib.persist.obj_pickle 函数中访问的是 obj.instance_name，因此 TestObject.__init__ 参数名需与之匹配（已同步修正为 instance_name）。
⚠️ 补充注意事项
-
不要尝试用
dill替代pickle来“绕过”此限制：虽然dill支持部分局部对象序列化，但它会引入不可控的兼容性风险（如跨 Python 版本、跨进程反序列化失败），且违背 pickle 的设计契约，不推荐用于生产级持久化逻辑。 -
确保类定义在
__main__或导入模块中：若类定义在if __name__ == "__main__":块内，或动态exec()创建，同样不可 pickle。 -
__slots__、自定义__getstate__/__setstate__等高级用法需额外验证，但本例中无需——顶层定义的普通类默认即可安全 pickle。
✅ 验证修复效果
运行测试应成功通过：
pytest tests/test_persist.py -v
输出类似：
test_obj_pickle PASSED
且生成的 .pkl 文件可在后续独立 Python 进程中被正确加载：
# 验证反序列化（非测试必需，但体现正确性）
import pickle
with open("test_dir/test_object_file.pkl", "rb") as f:
loaded = pickle.load(f)
assert isinstance(loaded, TestObject)总结：Pickle 的本质约束不是 pytest 引起的，而是 Python 对象模型与序列化机制的底层约定。坚持“类定义在模块层级”，是编写可持久化、可测试、可维护代码的基石实践。
