Python asyncio.gather 的错误传播控制

舞夢輝影

发布时间：2026-02-23 17:24:51

971人浏览过

来源于php中文网

原创

用 return_exceptions=true 可让 asyncio.gather 继续执行所有任务并返回包含异常对象的结果列表，再逐个判断类型处理；否则默认模式仅抛出首个异常并取消其余任务。

python asyncio.gather 的错误传播控制

asyncio.gather 抛出第一个异常就中断，怎么让它继续跑完所有任务？

默认情况下，asyncio.gather 遇到任一协程抛出异常，会立即取消其余未完成的任务，并把第一个异常直接 raise 出来——这和你“想等全部结束再统一处理错误”的直觉相悖。

根本原因是 asyncio.gather 的 return_exceptions=False（默认值）设计：它不把异常当返回值，而是当流程中断信号。

加参数 return_exceptions=True，所有结果（含 Exception 实例）都会原样放进返回列表
之后用 isinstance(..., Exception) 逐个判断，而不是靠 try/except 包裹整个 gather 调用
注意：即使开了这个开关，被取消的任务仍可能触发 CancelledError，但那是取消副作用，不是你原始协程抛的错

results = await asyncio.gather(
    fetch_user(1),
    fetch_user(999),  # 404 → HTTPError
    fetch_user(2),
    return_exceptions=True
)
for r in results:
    if isinstance(r, Exception):
        print(f"失败: {r}")
    else:
        print(f"成功: {r}")

为什么 try/except 包住 gather 还是捕获不到后续异常？

因为 asyncio.gather 在 return_exceptions=False 模式下，只抛出第一个异常，其余任务已被取消，它们的异常根本没机会冒出来——不是没捕获，是压根没发生。

常见误操作：写成这样以为能兜住所有错：

立即学习“Python免费学习笔记（深入）”；

try:
    await asyncio.gather(a(), b(), c())
except Exception as e:
    print("只看到这一个")

结果发现 b() 和 c() 的异常完全没打印。这不是异常被吞了，是它们根本没执行完就被 cancel 掉了。

微购社会化购物分享返利系统

升级说明：1.头像上传部分浏览器没法选择bug2.后台增加会员登录次数，后台修改会员密码功能3.b2c广告后台可以控制4.商品详情页面显示b2c返利价格和淘宝返积分bug5.修复360安全检测检测出的注册页面有跨站脚本攻击漏洞bug6.邀请好友链接地址bug7.后台自定义采集bug，采集后商品分类的数量不变bug8.后台30天推广量单位错误bug9.修复用户中心修改emali不起作用的b

下载

除非你显式调用 asyncio.create_task 并手动 await 每个，否则别指望 gather 默认模式返回多个异常
return_exceptions=True 是唯一标准解法；试图用 asyncio.wait + return_when=ALL_COMPLETED 也能做到，但代码更啰嗦、错误提取更麻烦

asyncio.gather 和 asyncio.wait 在错误收集上有什么实际区别？

asyncio.wait 确实能等全部完成（配 return_when=asyncio.ALL_COMPLETED），但它返回的是 (done, pending) 集合，每个 Task 的结果得手动 task.result() 取，而且一旦取到已失败的 task，就会立刻 raise 异常——你还是得包 try/except 在每一项上。

而 gather(..., return_exceptions=True) 直接给你一个对齐输入顺序的扁平列表，异常和值混排，处理起来更贴近“批处理”直觉。