Python contextvars模块：闭包内创建Context Variables的问题咨询

文档原文（翻译） #

上下文变量应在模块顶层创建，绝不能在闭包内创建。

上下文对象持有对上下文变量的强引用，这会阻止上下文变量被正确地垃圾回收。

一、闭包内创建ContextVar的示例 #

import contextvars

def outer_func():
    # 在闭包内部创建上下文变量
    inner_var = contextvars.ContextVar("inner_var")
    
    def inner_func():
        inner_var.set("测试值")
        print(inner_var.get())
    
    return inner_func

# 生成并执行闭包
my_func = outer_func()
my_func()

二、潜在问题分析 #

每次调用outer_func()时，都会在闭包作用域内生成一个全新的ContextVar实例。而Python的上下文对象（比如当前线程/异步任务的上下文）会对这个ContextVar持有强引用。

即使outer_func执行完成，后续如果不再使用inner_func，只要上下文对象还存在（比如异步任务未结束、线程上下文未销毁），这个闭包内创建的ContextVar就无法被回收。如果频繁调用outer_func，会不断积累无法被GC清理的ContextVar实例，最终导致内存泄漏。

三、与垃圾回收（GC）的关联 #

这个问题直接和GC相关。Python的垃圾回收机制依赖引用计数，当对象的引用计数降为0时才会被回收。上下文对象对ContextVar的强引用会持续维持其引用计数大于0，GC无法将其标记为可回收对象。长期运行下，这种情况会导致内存占用持续上升，引发内存泄漏问题。

内容的提问来源于stack exchange，提问作者Fang Hung-chien