Python中抛出自定义子异常时，父异常类型无法正常捕获的原因

Python 的异常匹配逻辑本身完全符合继承规则：只要抛出的异常类是 except 分支声明类的子类，就会被正常捕获。你遇到的匹配失效问题，本质是运行时加载了两份独立的异常类定义，导致抛出的异常类和你预期的父类不存在继承关系。

• 导入路径不一致：你在某个模块（比如app/auth/exceptions.py）里定义了新版的TokenProblem及三个子类，但抛出异常时引用的是旧路径下的、直接继承Exception的初代TokenNotInDatabase，而捕获分支用的是新模块下的TokenProblem，两者无关联，自然无法匹配。
• 循环导入导致类对象错位：如果异常定义模块和业务模块存在循环导入，Python 会先加载空的模块命名空间，实际拿到的类不是完成继承关系定义后的版本。
• 运行时未加载最新类定义：使用热重载功能的开发服务器、Python 交互式解释器，在修改完异常类继承关系后没有重启进程，内存中残留的仍是之前三个类直接继承Exception的旧定义，自然无法被TokenProblem捕获。
• 类名导入冲突：使用from 模块 import *这类批量导入写法时，同名类被后续导入的内容覆盖，导致实际捕获用的TokenProblem、抛出用的TokenNotInDatabase来自不同的定义源。

在异常捕获逻辑中打印实际抛出异常的类的继承链，即可直接定位问题：

try:
    proc_that_raises()
except TokenProblem:
    handle_exception()
except BaseException as e:
    # 输出实际异常类的完整继承顺序
    print(type(e).__mro__)

如果打印的继承链中不存在TokenProblem，即可确认抛出的并非你预期的子类。

• 统一所有异常类的导入路径，所有业务场景下都从同一个独立模块导入异常类，避免多份定义
• 修改完异常类结构后彻底重启 Python 进程，清除内存中残留的旧类定义
• 将异常类定义抽离为完全独立、不依赖任何业务逻辑的工具模块，从根源上避免循环导入问题

内容的提问来源于stack exchange，提问作者Reuben Gann