协程对象未及时回收导致内存持续上涨,因其持有闭包引用使大对象无法释放;需避免循环创建协程、显式管理任务生命周期、改闭包捕获为参数传递,并用 inspect.getclosurevars 等工具定位根因。

协程对象没被及时回收,内存持续上涨
Python 异步代码里,async def 定义的协程函数每次调用都会生成一个新协程对象,它会持有外层作用域的闭包引用(__closure__),哪怕你只 await 一次,只要协程对象没被 GC 回收,闭包里所有变量(比如大列表、缓存字典、数据库连接)就一直活着。
常见错误现象:psutil.Process().memory_info().rss 持续增长,但 gc.collect() 后不下降;用 objgraph.show_growth() 能看到大量 coroutine 实例堆积。
- 避免在循环中无节制创建协程:不要写
[do_work(i) for i in range(10000)],改用asyncio.create_task()+ 限流或分批 - 不用
asyncio.ensure_future()包裹已 await 的协程(比如ensure_future(await coro)是错的,await 后返回的是结果,不是协程) - 显式删除强引用:如果协程对象被存在列表或字典里(比如任务池),记得
del task_list[i]或用weakref.WeakSet存任务
闭包捕获了不该捕获的大对象
协程函数内部如果引用了外层的大数据结构(比如一个 50MB 的 config_dict 或 model_weights),这个对象会随协程对象一起驻留内存,直到协程执行完并被回收——而如果协程挂起时间长(如等待慢接口、sleep 长时间),问题立刻暴露。
使用场景:Web 请求处理中,把全局配置传进协程时直接闭包捕获;或在类方法里定义协程,意外持有了整个 self。
- 把大对象改成参数传入,而不是依赖闭包:写
async def fetch(url, session, cache),别写cache = big_cache; async def fetch(url): ... - 类方法中要小心
self:如果只是需要self.client,就提前解包成局部变量,或改用静态方法 + 显式传参 - 检查
coro.cr_frame.f_locals(调试时)或用inspect.getclosurevars(coro)看实际捕获了哪些变量
asyncio.create_task() 后忘记 await 或取消
create_task() 是把协程调度进事件循环,但它返回的 Task 对象本身是个强引用。如果你启动了任务却没 await 它、也没保存引用去 cancel,它可能卡在“已调度但未完成”状态,同时拖住所有闭包变量。
典型错误:在 FastAPI 路由里调用 create_task(log_event()) 就返回响应,但 log_event 协程里又闭包引用了请求体(request.body)——请求结束了,body 还在内存里。
- 必须确保每个
create_task()都有明确生命周期管理:要么 await 它,要么用asyncio.shield()包裹后存到后台集合,要么在退出前task.cancel() - 别依赖“任务自己会结束”:网络超时、异常未捕获都会让 Task 悬停;加
try/except CancelledError和finally清理资源 - 用
asyncio.current_task().get_coro()查当前协程对象,确认它没意外捕获外层上下文
调试时怎么快速定位内存根因
光看 RSS 没用,得知道谁在 hold 内存。Python 的异步内存问题往往藏在协程帧和闭包里,不是靠 tracemalloc 就能直接揪出来的。
性能影响:频繁创建/销毁协程本身开销不大,但闭包引用导致的内存滞留会让 GC 压力变大,尤其在高并发短连接场景下,可能引发周期性卡顿。
- 用
asyncio.all_tasks()列出所有活跃 Task,再对每个task.get_coro()调用inspect.getclosurevars(),筛出含大对象的协程 - 给关键协程加
__del__方法(仅调试):在协程类里定义,打印日志,确认是否被回收 - 禁用循环引用检测(
gc.disable())后观察内存变化——如果骤降,说明是 GC 延迟导致的假性泄漏,需检查协程间是否互相 await 形成环
真正难处理的是那些“逻辑上该结束,但因为某个 await 没触发、某个异常吞掉、某个回调没注册”而导致协程永远挂起的情况。这时候闭包就像胶水,把一堆本该释放的对象死死粘在一起。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











