如何解决继承自Exception的异常类pickle序列化报错问题

这个问题的核心原因是Python内置的Exception类在pickle序列化/反序列化时有一套特殊的处理逻辑，咱们来拆解清楚并解决它：

为什么会报错？ #

当你继承Exception时，pickle在反序列化阶段，会尝试用Exception.__new__创建实例，然后自动把原异常的args属性作为参数传给__init__。但你的Error类的__init__只接受self这一个位置参数，所以就会抛出TypeError——系统传了2个参数（self+args），但你的方法只认1个。

而你自定义的MyBaseException没有这种特殊逻辑，pickle会严格按照你写的__init__签名来调用，所以不会出问题。

解决方案（三种可选） #

方案1：修改__init__兼容pickle的调用逻辑

让你的异常类的__init__接受可变参数，既保留默认的错误信息，又能兼容pickle传参：

import pickle

class Error(Exception):
    def __init__(self, *args, **kwargs):
        # 如果没有传入参数，使用默认错误信息
        if not args:
            args = ("Some error message",)
        super().__init__(*args, **kwargs)

c = Error()
a = pickle.dumps(c)
b = pickle.loads(a)
print(b)  # 输出: Some error message

方案2：自定义__reduce__方法控制反序列化

__reduce__是pickle用来确定如何重建对象的特殊方法，我们可以直接指定构造函数和参数：

import pickle

class Error(Exception):
    def __init__(self):
        super().__init__("Some error message")
    
    def __reduce__(self):
        # 元组第一个元素是类，第二个是构造参数（空元组，因为__init__不需要参数）
        return (Error, ())

c = Error()
a = pickle.dumps(c)
b = pickle.loads(a)
print(b)  # 输出: Some error message

方案3：用__getstate__和__setstate__手动管理状态

这两个方法分别负责序列化时保存状态、反序列化时恢复状态：

import pickle

class Error(Exception):
    def __init__(self):
        super().__init__("Some error message")
    
    def __getstate__(self):
        # 保存异常的核心状态（这里用args即可）
        return self.args
    
    def __setstate__(self, state):
        # 从保存的状态恢复实例
        self.args = state
        # 调用父类初始化逻辑
        super().__init__(*state)

c = Error()
a = pickle.dumps(c)
b = pickle.loads(a)
print(b)  # 输出: Some error message

内容的提问来源于stack exchange，提问作者Sergey Dylda