asyncio.gather异常处理及任务终止方法

Python 中 `asyncio.gather()` 的异常处理机制远比表面复杂：它默认采用“快速失败”（fail-fast）策略，一旦任一协程抛出未捕获异常，不仅立即中断整个 `gather()` 调用、向上抛出该异常，还会主动取消所有仍在运行的其他任务——这可能导致资源泄漏、日志截断或 RuntimeError 警告；而通过 `return_exceptions=True` 可将异常“静默捕获”为结果列表中的对象，实现异常隔离；若任务本应完全独立（如监控与上报），则应摒弃 `gather()`，改用 `create_task()` 配合 `wait()` 或 `as_completed()` 进行精细化生命周期管理，并注意在取消后妥善清理、必要时使用 `shield()` 保护关键任务——理解这些细节，才能真正写出健壮、可预测的异步代码。

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学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！