You need to enable JavaScript to run this app. Python asyncio出现Task exception was never retrieved报错处理
优惠活动
大模型
产品
解决方案
定价
更多

Python asyncio出现Task exception was never retrieved报错处理

asyncio「Task exception was never retrieved」报错排查与修正

核心报错原因

你遇到的提示本质是两个会失败的子协程,有一个的异常全程没有被代码检索导致的,和你的初步判断完全吻合,也就是Task exception was never retrieved告警的触发逻辑:

  • 原coro函数遍历子协程时,直接await协程结果,没有任何异常拦截逻辑
  • 第一个触发失败的协程(对应数据b的下载任务)抛出异常后,会直接中断coro内部的循环流程
  • 第二个同样会失败的协程(对应数据c的下载任务)没有被await等待,它抛出的异常处于未被读取的状态
  • 外层gather(..., return_exceptions=True)仅能接收到从coro函数向上抛出的第一个异常,漏接了遗留协程的异常,最终在协程垃圾回收时触发告警。

可落地的修正方案

方案1:拦截子协程异常,保证完整遍历所有任务

给每个下载协程加一层异常捕获,让协程不会因为报错直接打断整个循环,确保所有子协程都被等待到:

async def coro(data_list):
    async def safe_download(data):
        try:
            return await download(data)
        except Exception as e:
            # 可在此处记录每个任务的执行状态/异常信息
            return e
    coroutines = [safe_download(data) for data in data_list]
    for coroutine in asyncio.as_completed(coroutines):
        await coroutine

这种写法完全兼容你原本按完成顺序处理任务的逻辑,不会漏接任何一个子协程的异常。

方案2:用gather统一处理内部协程异常

如果不需要严格按完成顺序处理结果,直接在内部调用环节用gather的异常透传能力替代手写循环,代码更简洁:

async def coro(data_list):
    coroutines = [download(data) for data in data_list]
    # 开启return_exceptions后,所有子协程的异常都会被收集,不会向上抛中断流程
    await asyncio.gather(*coroutines, return_exceptions=True)

两种写法都能保证所有子协程的异常被完整检索,运行时不会再出现告警提示。


内容的提问来源于stack exchange,提问作者SmiP

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 04:15:04