AttributeError: Can't get attribute 'XXX' on <module '__main__'> 是因反序列化时找不到类定义，pickle仅存模块路径+类名，需确保类已执行定义且导入路径一致。
反序列化时报 AttributeError: Can't get attribute 'XXX' on <module '__main__'>
这是最常见的 pickle 反序列化失败现象，本质是反序列化时找不到当时序列化所用的类定义。pickle 不保存类的完整代码，只存模块路径 + 类名，运行时靠 import 动态加载。
典型场景：你在 script.py 里定义了 class Model: 并用 pickle.dump() 保存了实例；之后改名文件、挪动类到其他模块，或在交互式环境（如 Jupyter）中重新运行脚本但没重定义类 —— 再用 pickle.load() 就会报这个错。
- 检查当前运行环境是否已执行过该类的定义（不是“有没有文件”，而是“有没有执行过
class语句”） - 如果类在
models.py中，确保加载前已import models，且序列化时也是从models.Model而非__main__.Model引用的 - Jupyter 用户特别注意：重启 kernel 后必须重新运行定义类的 cell，不能只靠“文件存在”
- 临时绕过法（仅调试）：
sys.modules['__main__'].Model = models.Model，但这是 hack，不可用于生产
遇到 ModuleNotFoundError 或 ImportError 提示找不到模块
说明 pickle 记录的模块路径（如 myproject.utils.Config）在当前 Python path 下无法解析。和上一条不同，这次是模块层级本身断了。
常见于：项目重构后包结构变化、用绝对路径序列化但在新环境以相对方式运行、或打包成可执行文件（如 PyInstaller）后模块被冻结导致路径失效。
立即学习“Python免费学习笔记（深入）”；
- 用
pickletools.dis()查看 dump 文件内容，确认其中记录的模块路径（搜索OBJ操作码后的字符串） - 在加载前手动补全路径：
sys.path.insert(0, '/path/to/your/project')，确保import myproject.utils能成功 - 避免在
__main__中定义要持久化的类；统一放到独立 .py 文件并用标准 import 引用 - PyInstaller 用户：把自定义模块加进
--add-modules，或在 hook 中显式导入
为什么不能直接用 pickle.loads() 解析不受信的数据
因为 pickle 的反序列化会执行任意代码 —— 它本质上是 Python 的字节码解释器。一个恶意构造的 pickle 流可以调用 os.system()、写文件、连接网络。
这不是“配置开关能关掉”的问题，而是设计使然。官方文档明确警告：pickle is not secure against erroneous or maliciously constructed data.
- 永远不要对来自用户上传、网络请求、数据库读取（未严格管控来源）的数据调用
pickle.load()或pickle.loads() - 替代方案优先级：JSON（无类型，需手动转换）、msgpack（快，支持二进制，但也不自带类还原）、dill（比 pickle 更强，但同样不安全）
- 若必须用 pickle，且数据源可控，可在加载前用白名单校验：重写
pickle.Unpickler.find_class()，只允许特定模块+类名，例如禁止任何含os、subprocess、builtins.eval的路径 - 黑名单方式极难完备（比如通过
getattr(builtins, 'exec')绕过），不推荐
类字段变更后反序列化失败：新增/删除字段、改类型、rename 属性
pickle 对类结构变化非常敏感。哪怕只是给 __init__ 加个默认参数，或删掉一个字段，都可能导致 TypeError 或属性值错乱。
根本原因是：pickle 保存的是实例的 __dict__ 快照 + 类引用，不包含字段声明逻辑。它不会调用 __init__，而是直接往空对象上塞属性。
- 兼容性修复首选
__setstate__：在类中定义该方法，对缺失键提供默认值，对多余键忽略，对旧字段名做映射 - 避免依赖
__getstate__做过滤，除非你明确知道哪些字段不该持久化（如缓存、文件句柄） - 字段类型变更（如
str → Path）需在__setstate__中主动转换，pickle 不做隐式类型适配 - 真正长期可靠的方案是换用 schema-based 序列化（如 Pydantic + JSON），而非依赖 pickle 的“原样还原”语义
b'V2\n' header），并在加载时做预检。 
