ExceptionGroup在类方法中需结合asyncio.gather等并发机制使用，不能用于顺序代码；必须用except*匹配子异常类型，而非普通except捕获，且需确保异常源自独立并发任务。
ExceptionGroup 在类方法中怎么捕获多个并发异常
Python 3.11 的 ExceptionGroup 不是为普通顺序代码设计的，它天然绑定在 asyncio 或 concurrent.futures 等并发场景下。如果你在类方法里直接 raise ExceptionGroup(...)，然后用 except ExceptionGroup: 捕获——语法上可行，但语义上容易误导：它不表示“多个错误同时发生”，而只是把一堆异常打包扔出去，失去了结构化处理的意义。
真正有用的方式是让类方法参与并发执行链。比如一个配置加载器类，要并行读取多个 YAML 文件：
import asyncio
from exceptiongroup import ExceptionGroup
<p>class ConfigLoader:
async def load_one(self, path):
try:
async with aiofiles.open(path) as f:
return await f.read()
except FileNotFoundError:
raise ValueError(f"Missing config: {path}")
except PermissionError:
raise PermissionError(f"Access denied: {path}")</p><pre class='brush:python;toolbar:false;'>async def load_all(self, paths):
results = await asyncio.gather(
*(self.load_one(p) for p in paths),
return_exceptions=True
)
# 过滤出异常，构造 ExceptionGroup（仅当有异常时）
errors = [r for r in results if isinstance(r, BaseException) and not isinstance(r, ExceptionGroup)]
if errors:
raise ExceptionGroup("Config loading failed", errors)
return results</pre>为什么不能用 try/except 直接包裹多个 raise
有人会写这样的类方法：
def risky_method(self):
try:
self.step_a()
self.step_b()
self.step_c()
except Exception as e:
raise ExceptionGroup("All steps failed", [e])这完全违背 ExceptionGroup 的设计意图。它只包装了**一个**异常，不是多个独立失败。更严重的是，step_b() 和 step_c() 根本没执行——你根本不知道它们是否也会失败。
立即学习“Python免费学习笔记（深入）”；
-
ExceptionGroup的价值在于保留多个独立异常的上下文，不是给单点错误换个名字 - 如果想收集多个步骤的错误，得用列表手动累积，再统一抛出：
errors = []+try...except...errors.append(...) - 但此时用
ExceptionGroup反而增加复杂度，不如直接 raise 自定义聚合异常类
如何用 except* 正确匹配类中抛出的 ExceptionGroup
except* 是唯一能解包 ExceptionGroup 的语法，但它要求匹配类型必须精确对应子异常类型，不是 ExceptionGroup 本身。
假设你的类方法在并发中触发了两类错误：
class DataProcessor:
async def process_batch(self, items):
tasks = [self.process_item(i) for i in items]
try:
await asyncio.gather(*tasks)
except ExceptionGroup as eg:
# ❌ 错误：这样捕获不到子异常
raise eg
<pre class='brush:python;toolbar:false;'>async def process_item(self, item):
if item < 0:
raise ValueError("Negative item")
elif item % 2 == 0:
raise RuntimeError("Even item disallowed")</pre>调用方必须用 except* 分别处理：
try:
await processor.process_batch([-1, 2, 5])
except* ValueError as eg:
print("ValueErrors:", [str(e) for e in eg.exceptions])
except* RuntimeError as eg:
print("RuntimeErrors:", [str(e) for e in eg.exceptions])注意：except* 不会回退到父类匹配（比如 except* Exception 不会捕获 ValueError），也不支持 as e 单一变量绑定——e 总是 ExceptionGroup 实例。
兼容性与调试时容易忽略的细节
Python 3.11+ 原生支持 ExceptionGroup 和 except*，但很多常用库（如 pytest、logging）对它的支持仍不完善：
-
logging.exception()会把ExceptionGroup当作普通异常打印，丢失子异常结构 -
pytest3.11 默认版本不识别except*语法，需升级到 pytest ≥7.2 并启用--tb=short才能看清分组信息 - IDE（如 PyCharm）的断点调试可能无法进入
except*分支，建议先用print(repr(eg))确认结构 - 若类方法被同步调用（非
await），又用了asyncio.gather，记得加asyncio.run()包裹，否则会报RuntimeWarning: coroutine ... was never awaited
最常被跳过的一步：检查子异常是否真的来自不同源头。两个 ValueError 实例放进同一个 ExceptionGroup，和一个 ValueError 加一个 TypeError，处理逻辑完全不同——类型粒度决定了 except* 能否真正分流。
