ExceptionGroup 是 Python 3.11 引入的异常容器类型，用于表示多个异常同时发生，需显式用 except ExceptionGroup: 捕获，其子异常通过 eg.exceptions 访问，不可被 except Exception: 捕获。
ExceptionGroup 是什么，为什么不能直接 try-except 捕获
Python 3.11 引入了 ExceptionGroup，用来表达“多个异常同时发生”的语义（比如 asyncio.gather(..., return_exceptions=False) 遇到多个协程出错时）。它不是普通异常的父类，而是一个容器类型——所以写 except Exception: 无法捕获 ExceptionGroup，更不会自动展开其子异常。
常见错误现象：
运行时报 ExceptionGroup: 2 exceptions，但没被任何 except 拦住，直接崩溃；或者用了 except Exception 却发现日志里啥都没打出来。
-
ExceptionGroup必须显式用except ExceptionGroup:或更宽泛的except BaseException:才能捕获 - 捕获后不能直接
raise原样抛出（除非你确定上层也支持），否则老版本 Python 会报NameError: name 'ExceptionGroup' is not defined - 它内部的异常可通过
eg.exceptions访问，是个 tuple，不自动递归扁平化
如何在 Python 3.11+ 正确捕获并处理 ExceptionGroup
最稳妥的方式是分层处理：先捕获 ExceptionGroup，再对每个子异常做分类响应。不要依赖“一次 except 解决所有问题”。
try:
# 可能抛出 ExceptionGroup 的代码，例如：
asyncio.run(some_risky_gather())
except ExceptionGroup as eg:
for exc in eg.exceptions:
if isinstance(exc, ValueError):
print("跳过数据校验失败:", exc)
elif isinstance(exc, ConnectionError):
print("网络异常，稍后重试:", exc)
else:
raise exc # 其他异常仍要传播
# 注意：这里不能直接 return 或静默吞掉，除非业务明确允许
except Exception as e:
# 处理非 ExceptionGroup 的普通异常
handle_regular_error(e)
- 别用
except BaseException:替代——它会捕获KeyboardInterrupt和SystemExit，影响调试和退出逻辑 -
eg.subgroup()可以筛选特定类型的子异常组，返回新的ExceptionGroup或None，适合做条件分流 - 若需统一日志，建议用
traceback.print_exception(eg)而不是str(eg)，后者只显示摘要
兼容旧版 Python（3.10 及以下）的 fallback 方案
如果你的代码要跑在未升级的环境里，ExceptionGroup 本身不存在，连 import 都会失败。不能靠 try/except NameError 在模块顶层 import，因为语法解析阶段就报错了。
立即学习“Python免费学习笔记（深入）”；
- 把涉及
ExceptionGroup的逻辑封装进函数内，延迟 import 判断：def safe_handle_exceptions():<br> try:<br> from exceptiongroup import ExceptionGroup<br> except ImportError:<br> ExceptionGroup = type(None)<br> # 后续逻辑基于 ExceptionGroup 是否为真实类型分支
- 更推荐用第三方 backport：
pip install exceptiongroup（官方维护），它在 Python <3.11 下提供兼容实现，且与标准库行为一致 - 注意：backport 的
ExceptionGroup类型跟 3.11 原生的不是同一个对象，做isinstance(eg, ExceptionGroup)时要确保用的是同一份定义
asyncio.gather + return_exceptions=True 容易忽略的陷阱
很多人以为设了 return_exceptions=True 就“安全了”，其实只是把异常转成结果列表里的元素，不等于错误被处理。一旦后续代码对结果做 result.method()，遇到 Exception 实例就会立刻崩。
- 必须显式检查每个结果是否为异常：
if isinstance(res, BaseException): ... - 若想统一转成
ExceptionGroup再集中处理，可以：exc_list = [r for r in results if isinstance(r, BaseException)]<br>if exc_list:<br> raise ExceptionGroup("gather failed", exc_list) - 别在
async with或finally块里盲目调用raise—— 如果当前作用域外没有except ExceptionGroup，就会触发未处理异常终止进程
ExceptionGroup 的核心不是“让多异常变少”，而是让多异常可识别、可分类、可追溯。漏掉对 exceptions 属性的遍历，或混淆 return_exceptions=True 和“已处理异常”，是最常导致线上静默失败的地方。
