except* 捕获 ExceptionGroup 时默认切断异常链,需对每个子异常显式使用 raise ... from e 才能保留 cause 和 context;直接 raise eg 或 raise 会丢失原始链。
Python 3.11 引入 except* 语法专门处理 ExceptionGroup,但它在匹配子异常后会**切断原始异常链**——即 __caus 和 
__context__ 不会自动继承到新异常中。如果你需要复用原始异常的上下文(比如日志溯源、调试时看到完整调用路径),必须手动重建。
在 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 # ← 这样链才保留
常见错误是捕获后直接 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 层级。