except * 只匹配直接子异常，不递归展开嵌套 ExceptionGroup；需用 except ExceptionGroup 捕获后手动扁平化处理。
捕获嵌套的 ExceptionGroup 需要显式递归遍历
ExceptionGroup 不会自动展开嵌套结构，except * 只匹配**直接子异常**，对嵌套在内层的 ExceptionGroup 无感知。比如你用 asyncio.gather(..., return_exceptions=True) 套了一层又一层任务，最终抛出的可能是 ExceptionGroup(ExceptionGroup(...), ValueError) ——此时 except * 只能抓到外层两个元素，抓不到最里层的 KeyError。
实操建议：
- 用
except ExceptionGroup as eg:捕获顶层，再手动调用eg.exceptions - 写个递归函数扁平化所有异常：检查每个子项是否为
ExceptionGroup，是则继续展开 - 避免依赖
except *处理深度嵌套场景，它不是“万能解包器”
except * 的匹配规则不递归，也不支持类型过滤嵌套成员
except * 的类型匹配只作用于当前层级的直接异常实例。例如 except * ValueError: 能捕获并列的 ValueError，但若它藏在某个子 ExceptionGroup 里，就不会被选中，也不会触发该 except * 分支。
常见错误现象：
- 写了
except * ValueError:却没进分支，实际异常是ExceptionGroup(ExceptionGroup(ValueError())) - 误以为
except *等价于“捕获所有可能抛出的异常类型”，其实它只看第一层结构 - 混用
except *和普通except时，普通except仍可能被外层ExceptionGroup阻断（除非加except BaseExceptionGroup:）
扁平化嵌套 ExceptionGroup 的最小可行代码
下面这个函数能收齐所有底层异常（包括嵌套中的），返回一个扁平的 list[BaseException]：
def flatten_exception_group(exc):
if isinstance(exc, ExceptionGroup):
result = []
for e in exc.exceptions:
result.extend(flatten_exception_group(e))
return result
return [exc]使用示例：
try:
...
except ExceptionGroup as eg:
all_excs = flatten_exception_group(eg)
for e in all_excs:
if isinstance(e, KeyError):
handle_missing_key(e)注意：flatten_exception_group 不改变异常的原始 traceback，但会丢失嵌套层级信息 —— 如果你需要保留“哪个子组出了什么错”，就得自己记录路径或用 eg.args 辅助分析。
异步任务链中嵌套 ExceptionGroup 的典型来源
最容易产生多层嵌套的不是手写的 ExceptionGroup，而是组合多个并发操作时的隐式构造：
-
asyncio.gather(a(), gather(b(), c()))→ 外层ExceptionGroup包含a()异常和一个内层ExceptionGroup -
asyncio.TaskGroup内部调用另一个TaskGroup，且两者都失败 -
exceptiongroup.ExceptionGroup手动构造时传入已含ExceptionGroup的列表
这些场景下，异常链的真实结构比表象复杂得多。别指望靠一次 except * 或一层 except ExceptionGroup 就覆盖全部情况 —— 必须根据调用链深度决定展开层数，或者统一用扁平化策略处理。
