asyncio.gather异常处理:任务失败后是否继续执行
时间:2026-03-26 14:04:38 168浏览 收藏
在 Python 的 asyncio 中,`asyncio.gather()` 默认采用“快速失败”(fail-fast)策略:一旦任一协程抛出未捕获异常,整个 gather 调用立即中止,不仅抛出该异常,还会主动取消所有其他仍在运行的任务——这意味着你可能丢失本可成功完成的结果、触发资源泄漏,甚至遭遇 `Task was destroyed but it is pending!` 等警告;但通过设置 `return_exceptions=True`,异常会被封装为结果列表中的 Exception 对象,让其余任务不受干扰地执行完毕,实现异常隔离;若任务逻辑本就相互独立(如监控与上报),更推荐使用 `create_task()` 配合 `wait()` 或 `as_completed()` 进行精细化控制,从而真正解耦生命周期、避免意外取消,并确保资源安全清理。

asyncio.gather() 默认会取消所有未完成任务
当 asyncio.gather() 中某个协程抛出未捕获异常时,它**不会静默忽略**,而是立即中断执行,并尝试取消其他仍在运行的任务。这是它的默认行为——即“fail-fast”,不是“fire-and-forget”。
常见错误现象:RuntimeError: Task was destroyed but it is pending! 或者看到部分任务日志没打完就退出,说明它们被强制取消了。
- 除非显式传入
return_exceptions=True,否则只要有一个任务失败,整个gather()就 raise 异常,且其余任务会被 cancel - 被 cancel 的任务如果没处理
asyncio.CancelledError,可能留下资源泄漏(比如未关闭的连接、未 flush 的文件) - 即使任务已开始执行,只要还没返回,就可能被中断——不保证原子性
如何让其他任务不受单个异常影响?
用 return_exceptions=True 参数,这样异常会被包装成 Exception 实例,和其他正常返回值一起放进结果列表里,后续逻辑可以自行判断和处理。
import asyncio
<p>async def task_a():
await asyncio.sleep(1)
raise ValueError("oops in A")</p><p>async def task_b():
await asyncio.sleep(2)
return "done B"</p><h1>这样写,task_b 会继续跑完</h1><p>results = await asyncio.gather(
task_a(),
task_b(),
return_exceptions=True
)</p><h1>results == [ValueError('oops in A'), 'done B']</h1><p></p>- 结果列表中对应位置是异常对象,不是抛出异常;你得用
isinstance(r, Exception)判断 return_exceptions=True不影响任务调度本身,只是改变异常传播方式- 注意:这不等于“重试”或“忽略”,只是把异常转为返回值,责任移交给你来处理
想彻底隔离任务,不共用生命周期怎么办?
如果任务之间本就不该互相干扰(比如一个监控任务 + 一个数据上报任务),gather() 本身就不是合适工具。应该改用 asyncio.create_task() 手动管理。
- 每个任务独立启动:
task_a = asyncio.create_task(task_a()),然后用asyncio.wait()或asyncio.as_completed()观察完成状态 asyncio.wait()支持return_when=asyncio.FIRST_EXCEPTION或ALL_COMPLETED,控制等待粒度- 记得在 finally 块或 shutdown 阶段显式
await task.cancel()并await task等待清理,避免 warning
容易被忽略的细节:异常类型和 cancel 的先后顺序
如果多个任务几乎同时出错,gather() 只会抛出**第一个被检测到的异常**,其余异常会被丢弃(除非用了 return_exceptions=True)。而 cancel 操作本身也可能触发新的异常(如 CancelledError),但它通常不会向上冒泡——除非你在任务里主动 raise 它。
- 不要依赖“哪个异常先抛出来”,它受事件循环调度、await 点、I/O 延迟等影响,不可预测
- cancel 后任务若还在做 CPU 密集型工作,可能无法及时响应;建议在长循环中定期加
await asyncio.sleep(0)让出控制权 - 使用
asyncio.shield()可防止某个关键任务被gather()的 cancel 波及,但要小心死锁
终于介绍完啦!小伙伴们,这篇关于《asyncio.gather异常处理:任务失败后是否继续执行》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识,快来关注吧!
相关阅读
更多>
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
480 收藏
-
472 收藏
-
447 收藏
-
261 收藏
-
314 收藏
-
363 收藏
-
469 收藏
-
184 收藏
-
421 收藏
-
491 收藏
-
335 收藏
-
489 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习