python runtime_error ai_generated true

Task exception was never retrieved future: <Task finished name='Task-5' coro=<worker() done, defined at app.py:42> exception=ValueError('bad payload')>

ID: python/task-exception-never-retrieved

其他格式: JSON · Markdown 中文 · English
80%修复率
89%置信度
0证据数
2024-08-02首次发现

版本兼容性

版本状态引入弃用备注
3.8 active — — —
3.9 active — — —
3.10 active — — —
3.11 active — — —
3.12 active — — —

根因分析

通过 asyncio.create_task() 创建的任务抛出异常，但没有人 await 该任务或附加完成回调，因此异常被丢弃。

English

A task created with asyncio.create_task() raised an exception, but no one awaited the task or attached a done callback, so the exception is discarded.

generic

解决方案

  1. 90% 成功率 
    Attach a done callback that logs exceptions:

def _log(task):
    if (exc := task.exception()):
        logger.exception('task failed', exc_info=exc)

task = asyncio.create_task(worker())
task.add_done_callback(_log)
  2. 95% 成功率 
    Keep strong references and await tasks in a TaskGroup (3.11+):

async with asyncio.TaskGroup() as tg:
    tg.create_task(worker())
  3. 85% 成功率 
    For fire-and-forget, store tasks in a module-level set and remove in the callback to prevent GC.

无效尝试

常见但无效的做法:

  1. 70% 失败

    Only adds more logging; the underlying exception is still lost.

  2. 80% 失败

    Hides real bugs and still leaves the task result unretrieved.

  3. 85% 失败

    Does not attach a handler to the task's exception.