为何用ABCMeta.register创建的抽象Exception虚拟子类不匹配except子句？

这个问题我之前也踩过坑，核心原因很明确：Python的except语句并不识别通过ABCMeta.register()创建的虚拟子类关系。它的异常匹配逻辑只认真实的继承链——也就是类的__bases__属性和实例的__class__所构成的层级结构，完全忽略虚拟子类的注册关系。

先看一个复现你问题的例子： #

from abc import ABCMeta, abstractmethod

# 你的自定义异常，用ABCMeta作为元类
class MyException(Exception, metaclass=ABCMeta):
    pass

# 第三方包抛出的异常
class ThirdPartyError(Exception):
    pass

# 注册ThirdPartyError为MyException的虚拟子类
MyException.register(ThirdPartyError)

# 这里检查是通过的
print(issubclass(ThirdPartyError, MyException))  # 输出: True
print(isinstance(ThirdPartyError(), MyException))  # 输出: True

# 但except MyException抓不到它
try:
    raise ThirdPartyError("第三方包出错了")
except MyException:
    print("捕获到MyException")  # 这条不会执行
except ThirdPartyError:
    print("捕获到ThirdPartyError")  # 这条会执行

为什么会这样？ #

Python的异常匹配逻辑是基于**异常实例的MRO（方法解析顺序）**来查找匹配的except块的。虚拟子类的关系不会被加入到类的MRO中，也不会被异常处理的底层逻辑识别——因为虚拟子类本质是一种"鸭子类型"的语法糖，只在isinstance()和issubclass()检查时生效，并没有改变类本身的继承结构。

解决方案：用异常包装替代虚拟子类 #

既然虚拟子类走不通，最可靠也最符合Python设计规范的方式是主动捕获第三方异常，包装成你的MyException抛出，同时保留原异常的上下文，方便调试。

示例代码：

class MyException(Exception):
    """自定义异常，模块所有对外抛出的异常都用这个"""
    pass

# 调用第三方代码的地方
def my_module_function():
    try:
        # 调用第三方包的函数
        third_party_library.do_something()
    except ThirdPartyError as original_err:
        # 包装成MyException抛出，用from保留原异常的因果关系
        raise MyException("模块操作失败") from original_err

这样，导入你模块的代码只需要写except MyException:就能捕获所有模块抛出的异常，完全不需要关心你内部用了什么第三方包。而且通过from关键字保留了原异常的信息，调试时也能追溯到问题根源。

其他不推荐的方案 #

1. 让第三方异常真实继承MyException：如果是你自己控制的异常类可以这么做，但第三方包的异常你没法修改，所以这个方案不适用。
2. 自定义元类修改异常匹配逻辑：虽然理论上可以通过修改元类的__instancecheck__或底层逻辑来让except识别虚拟子类，但这会破坏Python默认的异常行为，容易引入难以排查的问题，不推荐在生产代码中使用。

总结一下：用异常包装的方式是最稳妥的选择，既满足你的需求，又符合Python的异常处理最佳实践。

内容的提问来源于stack exchange，提问作者Mike McCoy