如何在 except* 中捕获 ExceptionGroup 但保留原始异常链

冰川箭仙 2026-01-23 00:00:00 次阅读

except* 捕获 ExceptionGroup 时默认切断异常链，需对每个子异常显式使用 raise ... from e 才能保留 cause 和 context；直接 raise eg 或 raise 会丢失原始链。

except* 捕获 ExceptionGroup 时默认不保留异常链

Python 3.11 引入 except* 语法专门处理 ExceptionGroup，但它在匹配子异常后会**切断原始异常链**——即 __cause__ 和 __context__ 不会自动继承到新异常中。如果你需要复用原始异常的上下文（比如日志溯源、调试时看到完整调用路径），必须手动重建。

用 raise ... from e 显式恢复异常链

在 except* 块内重新抛出异常时，不能只写 raise（它会抛出新包装的 ExceptionGroup，链已丢失），而要对每个捕获到的异常显式使用 raise ... from e。关键点：

except* 绑定的是匹配的子异常列表，不是原 ExceptionGroup 对象本身
需遍历 exc_group.exceptions 才能访问原始异常链信息
若想保留
整个组结构又带链，得手动构造新 ExceptionGroup 并逐个设置 __cause__

示例：

try:
    raise ExceptionGroup("outer", [
        ValueError("bad value").with_traceback(...),
        TypeError("wrong type").with_traceback(...)
    ])
except* ValueError as eg:
    # eg 是新的 ExceptionGroup，其内部异常已脱离原始链
    for e in eg.exceptions:
        # e 是原始 ValueError 实例，__cause__ 还在
        if e.__cause__ is not None:
            raise RuntimeError("wrap failed") from e  # ← 这样链才保留

避免误用 except* 后再 raise 原 ExceptionGroup

常见错误是捕获后直接 raise eg 或 raise，这会导致两层问题：

新抛出的 ExceptionGroup 是 except* 自动构造的副本，不含原始 __cause__/__context__
如果原 ExceptionGroup 是从某个 BaseException 链中 raise 出来的（比如被 except ValueError as e: raise ExceptionGroup(...) from e 包装过），这个 from e 关系在 except* 后就彻底消失了