如何在Python中弃用自定义异常类且保持对旧代码的向后兼容？

问题场景 #

现有固定逻辑无法修改的代码文件：

• a.py 原内容为自定义异常类A的定义
• try.py 内容为从a.py导入异常类A，捕获c.py抛出的对应异常

try.py具体内容如下：

from a import A
from c import raise_exception_of_A
try:
    raise_exception_of_A()
except A:
  print('Exception handled')
except Exception:
  print('Panic')

当前迭代后变更的内容：

• b.py 中重新定义了新版的异常类A
• c.py 中更新了raise_exception_of_A()函数，现在抛出的是b.py中定义的A类异常

核心约束 #

1. 不能修改try.py的任何内容
2. 只要代码使用从a.py导入的A，就需要触发弃用警告
3. 必须保证try.py中的异常捕获逻辑正常工作——因为两个A是不同模块定义的类，默认情况下isinstance判断会失效，旧的try.py无法捕获新的异常。

可行性结论 #

完全可以实现，仅需修改a.py即可满足所有约束。

具体实现 #

利用Python 3.7+支持的模块级__getattr__机制做拦截，不需要改动b.py的原有内容，修改后的a.py如下：

import warnings
# 提前导入b模块的新版A类，避免潜在的循环导入问题
from b import A as _NewA

def __getattr__(name: str):
    if name == "A":
        # stacklevel=2保证警告的定位指向实际使用a.A的代码位置，而非a.py内部
        warnings.warn(
            "从a导入A已弃用，请迁移为从b导入A",
            DeprecationWarning,
            stacklevel=2
        )
        # 返回b模块原生的A类引用，从根源上保证异常匹配生效
        return _NewA
    raise AttributeError(f"模块a不存在属性 {name}")

原理解释 #

1. 异常匹配兼容：当try.py执行from a import A时，Python会先查找a模块的顶层属性，发现没有定义A，就会自动调用模块的__getattr__("A")方法，最终返回的对象就是b.py中定义的原始A类。此时except A的匹配逻辑和直接从b导入A完全一致，c.py抛出的异常可以被正常捕获，不会触发两个独立类之间isinstance判断为False的问题。
2. 弃用警告生效：所有对a.A的访问，不管是from a import A的导入形式，还是import a之后手动访问a.A的形式，都会经过__getattr__的拦截逻辑，准确触发弃用提示，解决了直接桥接导入没有警告的问题。相比直接在模块顶层导入加警告的方式，这种拦截方式粒度更精准，只有真正访问A属性时才触发警告，不会对导入a模块但不使用A的代码造成干扰。
3. 低侵入性：b.py不需要做任何修改，保持原有A类的定义即可。

补充说明 #

如果项目需要兼容Python 3.6及更早的不支持模块级__getattr__的版本，可以通过自定义模块类型、重写属性访问逻辑的方式实现等价的拦截效果，核心思路一致：拦截对a.A的访问，触发警告后返回b的原生A类，而非自己定义一个全新的A类。

内容的提问来源于stack exchange，提问作者Andi Domi