weakref 如何正确使用来避免循环引用导致内存泄漏

weakref 的核心用途是打破循环引用以防内存泄漏,即不持有强引用而仅临时获取对象,允许其被及时销毁;典型应用是在子对象对父对象的反向引用中使用 weakref.ref,并每次调用后检查是否为 None。

在 Python 中,weakref 的核心用途之一就是打破循环引用,防止对象无法被垃圾回收(GC),从而避免内存泄漏。关键在于:**不持有强引用,只在需要时临时获取对象,且允许对象在无其他强引用时被及时销毁。**

理解循环引用为何导致泄漏

Python 主要靠引用计数 + 周期性 GC 清理循环引用。但若两个对象互相持强引用(如父

对象存子列表,子对象又存父引用),即使外部不再使用它们,引用计数也不为 0,只能依赖 GC。而 GC 并非实时触发,尤其在 CPython 中,某些场景(如含 __del__ 方法的对象)可能完全不被 GC 处理,造成泄漏。

例如:

class Parent:
    def __init__(self):
        self.children = []

class Child: def init(self, parent): self.parent = parent # 强引用父对象 parent.children.append(self)

p = Parent() c = Child(p) # p ↔ c 形成循环引用 del p, c # 对象仍驻留内存,可能不被回收

用 weakref 替代强引用的关键位置

应在“从属方”对“主控方”的反向引用处使用 weakref,即子对象引用父对象、缓存引用目标、回调中保存对象等场景。

  • weakref.ref 包装父对象,调用时加 () 获取(可能返回 None
  • weakref.WeakKeyDictionaryWeakValueDictionary 管理映射关系,键或值被销毁时自动清理条目
  • 避免在 __del__ 中访问 weakref 对象(此时对象可能已部分析构)

典型安全写法示例

修正上面的父子关系:

import weakref

class Parent: def init(self): self.children = []

class Child: def init(self, parent): self._parent_ref = weakref.ref(parent) # 弱引用 parent.children.append(self)

@property
def parent(self):
    return self._parent_ref()  # 调用 ref 对象获取实例,可能为 None

p = Parent() c = Child(p) print(c.parent is p) # True del p print(c.parent) # None — 安全,不崩溃

注意:self._parent_ref() 是动态取值,不是缓存强引用;每次使用都应检查是否为 None

其他实用 weakref 工具与注意事项

weakref.finalize 可注册对象销毁时的清理逻辑,比 __del__ 更可靠;weakref.WeakSet 适合管理一组可随时消失的对象。

  • 不要对不可弱引用类型(如 int、str、tuple)创建 weakref,会报 TypeError
  • 避免长期持有 weakref.ref 实例本身(它自己也是对象),若 ref 对象还活着,目标对象无法被回收
  • 多线程中使用 weakref 是安全的,但访问解引用结果仍需自行同步