exceptiongroup是python 3.11为并发/批量任务设计的异常聚合机制，需显式构造并用except捕获，与类定义无关；手动构造需传非空异常列表，捕获时必须用except匹配子异常类型。
ExceptionGroup在Python 3.11中不是用来捕获“类中多个异常”的
它根本不管异常发生在哪个类里，只关心你是否**显式用 except* 捕获一组并发抛出的异常**。常见误解是以为给类方法加个装饰器就能自动聚合异常——不行。Python 3.11 的 ExceptionGroup 是为 asyncio.gather(..., return_exceptions=True) 或 threading 多任务、concurrent.futures 批量执行等场景设计的，和“类定义”本身无关。
如果你在类方法里手动 raise 多个异常（比如循环中连续 raise ValueError），那它们仍是逐个抛出、逐个中断，不会自动打包成 ExceptionGroup —— 除非你主动构造。
怎么手动构造并捕获 ExceptionGroup
典型流程：收集子异常 → 包装成 ExceptionGroup → 用 except* 解构。注意：except* 是 Python 3.11 新增语法，不能用普通 except 捕获。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
-
ExceptionGroup构造必须传入一个非空异常列表，例如ExceptionGroup("validation failed", [ValueError("a"), TypeError("b")]) - 捕获时必须用
except* ValueError:这种形式，匹配组内所有符合类型的异常；若写except ValueError:，会完全错过整个组 - 一个
except*块只能处理组中匹配的子异常，未被匹配的异常会继续向上冒泡（可能触发外层except*或最终崩溃）
try:
raise ExceptionGroup("api errors", [
ConnectionError("timeout"),
ValueError("bad json")
])
except* ConnectionError as eg:
print(f"Connect issues: {eg.exceptions}")
except* ValueError as eg:
print(f"Data issues: {eg.exceptions}")
在类方法里安全使用 ExceptionGroup 的实际模式
不要指望类自动聚合异常。正确做法是：在类中封装一批可并发/可批量执行的操作，并统一收口处理结果。比如验证多个字段：
- 用
list收集所有异常，而不是中途raise；最后再决定是否打包抛出ExceptionGroup - 避免在
__init__或普通同步方法里直接 raiseExceptionGroup，因为调用方大概率没写except*，会导致 UnhandledExceptionGroup - 如果类方法返回
ExceptionGroup（而非抛出），调用方更可控，也便于测试
class Validator:
def validate_all(self, data):
errors = []
if not data.get("email"):
errors.append(ValueError("email required"))
if len(data.get("name", "")) <h3>容易踩的坑：except* 不支持嵌套匹配，也不兼容旧代码</h3><p><code>except*</code> 只做扁平匹配：它检查 <code>ExceptionGroup.exceptions</code> 中每个元素的类型，不递归进嵌套的 <code>ExceptionGroup</code>。而且——</p>
- 任何没被
except*覆盖的异常类型，哪怕在组里，也会导致整个组未被处理，最终报Uncaught ExceptionGroup - Pytest、IPython、Jupyter 默认不支持
except*的 traceback 渲染，可能只显示第一行，调试困难 - 第三方库（如
requests,sqlalchemy）完全不产生ExceptionGroup，别幻想它们会“自动适配”
真正要用好，得从任务调度层开始设计，比如用 asyncio.create_task 并发请求，再用 await asyncio.gather(..., return_exceptions=True) 收集结果，最后用 except* 分流处理——这才是 ExceptionGroup 的原始战场。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
