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*后就彻底消失了
正确做法:要么在 except* 前就记录原始异常对象,要么改用普通 except ExceptionGroup as eg: + 手动遍历处理。
兼容性与调试提示
当前(Python 3.11–3.13)没有内置机制让 except* 自动透传异常链。调试时注意:
-
traceback.print_exception()在except*内打印eg时,显示的是“干净”的组结构,不体现原始嵌套关系 - 想查原始链,必须访问
eg.exceptions[0].__cause__等字段,而不是依赖eg本身 - 若项目需强异常溯源,建议暂时避开
except*,改用传统except ExceptionGroup+ 显式循环处理
真正保留链的逻辑,始终发生在单个异常实例上,而非 ExceptionGroup 层级。










