“Task was destroyed”是RuntimeWarning警告,本质是未完成的asyncio.Task被垃圾回收时仍处于挂起状态,常见于未await、未取消且丢弃的Task。

Task was destroyed 错误的本质原因
这个错误不是异常,而是 asyncio 的日志警告(通常以 RuntimeWarning 形式抛出),核心原因是:一个尚未完成的 asyncio.Task 在被垃圾回收前,其协程对象仍处于挂起(suspended)状态。常见于未显式等待、未取消就丢弃的 Task,比如在函数返回前忘了 await 或 asyncio.create_task() 后直接脱离作用域。
典型触发场景包括:
- 在异步函数里调用
asyncio.create_task()但没保存引用,也没 await 它 - 使用
asyncio.ensure_future()启动后台任务,但父协程提前退出 - 在
<strong>aexit</strong>或信号处理中未清理 pending Task - 单元测试里启动了 task 但 test 函数结束时 event loop 已关闭
如何复现并确认是 Task 被销毁而非崩溃
先写一段稳定复现的代码验证问题模式:
import asyncio import warnings <p>async def dummy(): await asyncio.sleep(0.1)</p><p>async def main(): asyncio.create_task(dummy()) # ❌ 没有赋值给变量,也没有 await</p><h1>函数立即返回,task 还在 sleep 中就被 GC</h1><p>asyncio.run(main())</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记(深入)</a>”;</p>
运行后会看到类似输出:
RuntimeWarning: Task was destroyed but it is pending!
注意:这不会中断程序执行,但说明资源泄漏风险已存在。可通过捕获警告确认:
warnings.filterwarnings("error", category=RuntimeWarning)
安全启动后台任务的三种做法
真正解决问题,不是压制警告,而是让 Task 生命周期可控:
- 直接
await它(如果逻辑上允许阻塞) - 用变量持有引用,并在合适时机
await task或task.cancel() - 将 task 加入全局集合(如
asyncio.all_tasks()可查),并在 shutdown 前统一asyncio.gather(*tasks, return_exceptions=True)
推荐模式(带自动清理):
_background_tasks = set() <p>async def spawn(task): t = asyncio.create_task(task) _background_tasks.add(t) t.add_done_callback(_background_tasks.discard) return t</p><h1>使用</h1><p>await spawn(dummy()) # 不阻塞,但 task 不会被意外销毁</p>
单元测试和 CLI 工具中的常见陷阱
测试框架(如 pytest-asyncio)默认每个 test 函数对应独立 event loop,若在 test 中调用 asyncio.create_task() 后没等完,test 结束即 loop 关闭 → Task 强制销毁。
解决办法:
- 测试中一律用
await或asyncio.wait_for(task, timeout=...) - 避免在
setup阶段启动长期运行 task;改用 fixture 显式管理生命周期 - CLI 工具(如基于
click的 async command)中,不要在 click callback 里直接create_task,应把整个逻辑包进asyncio.run()或用asyncio.run_coroutine_threadsafe()(需配合 running loop)
最易被忽略的一点:Python 3.12+ 对未完成 task 的销毁警告更严格,且某些 asyncio 实现(如 uvloop)可能直接 raise CancelledError 而非警告——所以不能依赖“没报错就等于没问题”。



















