asyncio.gather()默认不中断其他任务,所有协程并发执行直至完成;异常在全部结束后统一抛出(return_exceptions=False),或以Exception对象形式存入结果列表(return_exceptions=True)。

是的,asyncio.gather() 中某个任务异常后,其他任务默认仍会继续执行,直到全部完成(或取消)。
默认行为:异常不中断其他任务
除非显式设置 return_exceptions=False(默认值),否则 gather() 会在所有协程都结束之后才抛出第一个遇到的异常。期间其他任务照常运行,不会被自动取消或中断。
- 所有任务并发启动,彼此独立调度
- 即使一个协程抛出异常,事件循环仍会继续推进其余协程
- 最终返回结果列表中,异常会以
Exception实例形式存在(若设了return_exceptions=True);否则在全部完成后统一 raise 第一个异常
如何让异常立即中断其他任务
如果希望某个任务失败时立刻停止其余任务,不能依赖 gather() 默认逻辑,需手动处理:
- 用 asyncio.create_task() 显式创建任务,再配合 asyncio.wait() 或 asyncio.shield() 控制生命周期
- 捕获异常后调用 task.cancel() 主动取消其余任务
- 或者改用 asyncio.wait(..., return_when=asyncio.FIRST_EXCEPTION),它会在首个异常发生时立即返回,便于你主动终止其余任务
常见误区提醒
有人误以为 gather() 像同步代码中的 for 循环一样“遇到错误就停”,但它是异步并发原语,设计目标就是并行协调多个协程。它的“异常传播策略”是事后集中处理,而非实时中断。
-
return_exceptions=True:结果列表里保留异常对象,不抛出,适合容错场景 -
return_exceptions=False(默认):所有任务结束后,只 raise 第一个异常,其余任务仍跑完 - 异常本身不会自动取消其他任务——取消必须由你显式触发
不复杂但容易忽略:异常和取消是两个独立机制,gather 负责聚合,不负责干预执行流。










