Python自定义Exception默认无法被pickle安全序列化，根本原因是pickle依赖类的可导入路径；必须将异常类定义在独立可导入模块（如errors.py）中，避免在__main__中定义，并确保实例仅包含可序列化字段。
Python 的自定义 Exception 默认无法被 pickle 安全序列化，尤其是当类定义在 __main__ 或动态模块中时，反序列化会报 AttributeError: Can't get attribute 'MyError' on <module '__main__'>。根本原因不是“没写 __reduce__”，而是 Python 的 pickle 依赖类的可导入路径 —— 必须让异常类能被从模块顶层 import 到达。
确保异常类定义在可导入的独立模块中
这是最关键的一步。把异常类放到一个单独的 .py 文件（比如 errors.py）里，并保证它能被常规 import 导入，而不是只在脚本里定义：
# errors.py
class ValidationError(Exception):
def __init__(self, message, code=None, context=None):
super().__init__(message)
self.code = code
self.context = context or {}
然后在主程序中 import 使用，而不是直接在 if __name__ == '__main__': 下定义它。否则 pickle 会尝试从 __main__ 模块找类，而反序列化时该模块不存在或结构不同。
避免在异常中存不可序列化的对象
即使类本身可导入，如果实例持有像 threading.Lock、socket.socket、lambda、或带闭包的函数这类对象，pickle.dumps() 会直接失败或产生不一致行为：
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
-
self.request（Django/Flask 的 request 对象）不能直接存进异常实例 -
self.db_conn（数据库连接）必须设为None或在__getstate__中剔除 - 如果用了
dataclasses或attrs自动生成__init__，检查所有字段是否都支持 pickle
推荐做法是只保留基本类型（str, int, dict, list, None）或明确可序列化的对象。
必要时手动控制 pickle 行为（__reduce__ 或 __getstate__）
绝大多数情况不需要重写，但如果你确实需要定制（比如隐藏敏感字段、或兼容旧版本），可以加 __getstate__：
class ValidationError(Exception):
def __init__(self, message, code=None, context=None):
super().__init__(message)
self.code = code
self.context = context or {}
self._internal_id = id(self) # 不想序列化这个
<pre class='brush:python;toolbar:false;'>def __getstate__(self):
state = self.__dict__.copy()
state.pop('_internal_id', None)
return state注意：__reduce__ 更底层，一般只在类构造逻辑复杂（比如需要调用静态工厂方法）时才用；95% 的场景，靠模块可导入 + 字段干净就足够了。
最容易被忽略的点是：你以为序列化成功了，其实只是因为当前进程还没退出 —— __main__ 里的类在同进程内能 round-trip，但换进程或重启后就失效。真正验证是否可序列化，一定要跨进程测试，比如用 multiprocessing 或把 pickle.dumps() 结果存文件再读取反序列化。
