asyncio.create_task()创建的任务若无引用会立即被gc回收,需显式保存引用或用taskgroup统一管理生命周期。

asyncio.create_task() 后任务立刻消失?检查是否丢失了引用
asyncio 任务对象一旦创建,如果没有任何变量持有它的引用,Python 的垃圾回收器会在下一次 GC 时直接销毁它——哪怕它还没开始运行或正在等待 await。这不是 bug,是设计使然:asyncio.create_task() 返回的是一个 Task 对象,和普通对象一样受引用计数与 GC 管理。
常见误写:
async def background_job():
await asyncio.sleep(5)
print("done")
<h1>❌ 错误:task 没有被任何变量持有,立即被 GC 回收</h1><p>asyncio.create_task(background_job())
</p>
正确做法是显式保存引用:
- 存入模块级列表(如
background_tasks = [],然后background_tasks.append(asyncio.create_task(...))) - 作为类属性保存(
self._task = asyncio.create_task(...)),尤其适合在__aenter__中启动、__aexit__中cancel()的场景 - 用
asyncio.ensure_future()不解决根本问题,它同样返回可被 GC 的对象,只是兼容旧代码的包装
使用 asyncio.get_event_loop().create_task() 会更安全吗?
不会。loop.create_task() 和 asyncio.create_task() 行为完全一致,都返回裸 Task 对象。区别仅在于调用方式(后者自动获取当前事件循环),但引用管理责任完全没变。
注意两个关键点:
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能,主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践;生成安全服务方案文档;核心要点生成技术架构设计文档;生成任何需要专业排版的Word文档;核心库 : python-docx;使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns;标准代码模板;1. 文档初始化;2. 字体设置(必须!它将相关步骤、工具调用和结果整理方式集
-
asyncio.create_task()是推荐方式(Python 3.7+),loop.create_task()已不鼓励直接使用 - 无论哪种,只要没变量引用,任务就会“静默消失”,不会报错,也不会留下日志——这是最危险的地方
- 如果你在调试时发现
print()或logging.info()完全没输出,先检查任务是否被 GC 掉,而不是怀疑协程逻辑
如何可靠地长期维持后台任务并支持优雅退出?
靠手动维护引用容易遗漏或泄漏,更健壮的做法是统一管理生命周期。推荐组合使用:
- 用
asyncio.TaskGroup(Python 3.11+):自动持有所有子任务引用,且支持await等待全部完成或异常传播 - 用
asyncio.create_task()+ 显式集合管理 +asyncio.shield()包裹关键清理逻辑(防止被cancel()中断) - 避免依赖
asyncio.all_tasks()做“兜底”——它只返回当前 loop 中未完成的任务,但无法区分哪些是你有意保留的、哪些是临时产生的
示例(Python 3.11):
async def main():
async with asyncio.TaskGroup() as tg:
tg.create_task(background_job()) # 自动加入组,main 结束时自动 await 所有
await asyncio.sleep(1)
为什么 asyncio.run() 结束后后台任务一定被杀?
asyncio.run() 内部会调用 loop.close(),而关闭事件循环前会强制 cancel() 所有剩余 Task,并等待它们结束(最多 1 秒)。即使你用全局变量存了 Task 引用,也逃不过这一关。
所以真正需要“长期运行”的后台任务,不能依赖 asyncio.run() 单次执行,必须:
- 自己管理事件循环(
loop.run_forever()),并在合适时机调用loop.stop() - 改用异步框架(如 FastAPI 的
lifespan、AIOHTTP 的on_startup/on_cleanup)来绑定生命周期 - 或者把任务拆成独立进程(
multiprocessing或subprocess),彻底脱离主 event loop 的生命周期约束
GC 误杀只是表象,背后其实是任务生命周期与事件循环生命周期没对齐——这点最容易被忽略。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










