Python 3.11+ 的 ExceptionGroup 如何与 asyncio.gather 配合捕获
技术百科
冷炫風刃
发布时间:2026-01-27
浏览: 次 asyncio.gather默认将所有异常聚合成ExceptionGroup,即使仅一个协程出错;需用except*捕获特定类型异常,或设return_exceptions=True避免ExceptionGroup。
asyncio.gather 默认把多个异常打包成 ExceptionGroup
Python 3.11 引入 ExceptionGroup 后,asyncio.gather 在多个协程出错时不再抛出第一个异常,而是把所有异常聚合成一个 ExceptionGroup。这意味着你不能用老办法——比如只捕获 ValueError 或 Exception——来拿到全部错误信息。
常见错误现象:
你写了 await asyncio.gather(a(), b(), c()),其中 b() 和 c() 都抛了 TimeoutError,但 try-except 块里什么也没捕获到,或者只看到 ExceptionGroup: 2 exceptions 而无法访问具体异常。
-
asyncio.gather(..., return_exceptions=False)(默认):任一子协程失败 → 整体 raiseExceptionGroup -
asyncio.gather(..., return_exceptions=True):所有异常都转为结果列表里的Exception实例,不触发ExceptionGroup - 即使只一个协程出错,也会包装成含单个异常的
ExceptionGroup(不是原异常类型)
用 except* 捕获 ExceptionGroup 中的特定异常类型
except* 是 Python 3.11 新增语法,专为 ExceptionGroup 设计。它会从组中“筛选”出匹配类型的异常子集,而不是要求整个组匹配某个类型。
示例场景:你想分别处理 TimeoutError 和 ConnectionError,且不希望漏掉任何一个:
try:
await asyncio.gather(task_a(), task_b(), task_c())
except* TimeoutError as eg:
print(f"超时了 {len(eg.exceptions)} 次")
for e in eg.exceptions:
print(" -", e)
except* ConnectionError as eg:
print("连接问题,忽略重试")
except* Exception as eg:
# 捕获剩下所有未被前面 except* 匹配的异常
print("其他异常:", eg)
-
except*不是“或”关系,而是“提取子集”:每个块只看到自己类型的部分异常 - 多个
except*块可共存,互不影响;顺序无关(不像普通except) - 不能混用
except和except*在同一个 try 块里(SyntaxError)
手动解包 ExceptionGroup 获取原始异常链
有时候你需要检查异常上下文、traceback 或触发原因(比如哪个 task 抛了错),而 except* 只给子集。这时得手动遍历 exceptions 属性,并注意嵌套可能:
-
ExceptionGroup.exceptions是元组,元素可能是普通异常,也可能是另一层ExceptionGroup - 推荐用
exceptiongroup.ExceptionGroup.split()辅助分类(需安装exceptiongroupbackport 包用于 3.11 之前,但 3.11+ 已内置) - 若要保留 traceback,别用
str(e),改用traceback.format_exception(type(e), e, e.__traceback__)
小技巧:在日志中打印完整结构:
import tracebacktry: await asyncio.gather(a(), b(), c()) except ExceptionGroup as eg: print("完整异常组:") for i, exc in enumerate(eg.exceptions): print(f"[{i}] {type(exc).name}: {exc}")
打印 traceback(仅限
非嵌套异常)
if not isinstance(exc, ExceptionGroup): tb = "".join(traceback.format_exception(type(exc), exc, exc.__traceback__)) print(tb.strip().split("\n")[-3:]) # 只看最后三行与 return_exceptions=True 配合时无需 ExceptionGroup 处理
如果你更习惯传统错误处理逻辑(比如逐个检查结果、手动 raise),可以关掉
ExceptionGroup自动聚合:
- 设
return_exceptions=True→gather总是返回 list,成功结果和异常对象并存 - 此时你得自己遍历结果,用
isinstance(r, Exception)判断是否出错 - 优点:兼容旧代码、调试直观;缺点:丢失异常聚合语义(比如无法区分“三个 timeout”和“一个 timeout + 两个 json decode error”)
示例:
results = await asyncio.gather(
fetch("a"), fetch("b"), fetch("c"),
return_exceptions=True
)
for i, r in enumerate(results):
if isinstance(r, Exception):
print(f"task {i} failed: {r}")
# 这里可以单独处理,比如记录、重试、raise 等
真正容易被忽略的是:哪怕你只启动了一个协程,asyncio.gather(single_coro()) 出错时依然返回 ExceptionGroup——它不是“多任务专属”,而是 gather 的统一错误模型。别假设“只有一个任务就不会遇到 ExceptionGroup”。
# ai
# 的是
# 写了
# 不像
# 多个
# 第一个
# 你想
# 也会
# python
# 你不
# js
# json
# Error
# 对象
# 重试
# try
# 遍历
# raise
相关栏目:
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
AI推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
SEO优化<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
技术百科<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
谷歌推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
百度推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
网络营销<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
案例网站<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
精选文章<?muma echo $count; ?>
】
相关推荐
- Win11时间怎么同步到原子钟 Win11高精度时
- Win10闹钟铃声怎么自定义 Win10闹钟自定义
- Win10怎样清理C盘爱奇艺缓存_Win10清理爱
- Go 中的 := 运算符:类型推导机制与使用边界详
- Mac如何创建和管理多个桌面空间_Mac高效多任务
- Win10电脑C盘红了怎么清理_Windows10
- Win10电脑怎么设置休眠快捷键_Windows1
- Python 中将 ISO 8601 时间戳转换为
- c++怎么实现大文件的分块读写_c++ 文件指针s
- Python数据挖掘进阶教程_分类回归与聚类案例解
- Linux怎么实现内网穿透_Linux安装Frp客
- Win11如何设置系统声音_Win11系统声音调整
- Python并发安全问题_资源竞争说明【指导】
- php下载安装后memory_limit怎么设置_
- Win11如何设置ipv6 Win11开启IPv6
- Win11怎么设置闹钟_Windows 11时钟应
- 如何使用Golang进行HTTP服务性能测试_测量
- LINUX的SELinux是什么_详解LINUX强
- Win11开机Logo怎么换_Win11自定义启动
- php接口返回数据乱码怎么办_php接口调试编码问
- Win11怎么设置环境变量_Win11配置Path
- Win11怎么更改默认打开方式_Win11关联文件
- php怎么下载安装后设置错误日志_phpini l
- C++如何使用std::transform批量处理
- C#如何使用XPathNavigator高效查询X
- Windows11怎么用“记事本”自动换行与编码
- 手机php文件怎么变成mp4_安卓苹果打开php转
- Win10怎样卸载TeamViewer_Win10
- Win10怎样清理C盘Steam游戏缓存_Win1
- phpstudy本地环境mysql忘记密码_重置m
- php删除数据怎么清空表_truncate与del
- Win11声音太小怎么办_Windows 11开启
- Windows10如何更改任务栏高度_Win10解
- Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱
- Win11怎么设置ip地址_Windows 11手
- php下载安装后swoole扩展怎么安装_异步框架
- 短链接怎么自定义还原php_修改解码规则适配需求【
- Win11怎么开启远程桌面_Win11系统远程桌面
- 如何使用Golang实现多重错误处理_Golang
- Win11怎么设置多显示器任务栏 Win11扩展任
- Win11怎么硬盘分区 Win11新建磁盘分区详细
- Win11讲述人怎么关闭_Win11误触开启语音朗
- Win11如何设置系统语言_Win11系统语言切换
- 如何在Golang中处理模块包路径变化_Golan
- PHP接收参数值为空怎么办_判断和处理空参数方法说
- Win11怎么设置DNS服务器_Windows11
- Win11怎么激活Windows10_Win11激
- php485读数据时阻塞怎么办_php485非阻塞
- 如何在Golang中理解指针比较_Golang地址
- Python安全爬虫设计_IP代理池与验证码识别策


QQ客服