weakref.ref不能直接当对象用,因其返回的是可调用弱引用对象而非原始实例,直接使用会报TypeError;正确做法是每次通过ref()取值并判空,适用于子持父等需避免循环引用的场景。

weakref.ref 为什么不能直接当对象用?
直接调用 weakref.ref 返回的是一个可调用对象,不是原始实例本身。常见错误是把它当成原对象传给函数或赋值给属性,结果运行时报 TypeError: 'weakref' object is not callable 或后续访问失败。
- 正确做法:每次使用前必须显式调用它,比如
obj_ref(),且要检查返回值是否为None(目标已被回收) - 典型场景:在回调、观察者模式中保存对“持有者”的弱引用,避免监听器阻止持有者被释放
- 别写
self.parent = weakref.ref(parent)然后直接用self.parent.do_something()—— 这会崩
weakref.WeakKeyDictionary 适合做缓存但不支持不可哈希类型
它内部用键的 identity 做弱引用管理,键被销毁时对应条目自动清理。但只接受可哈希对象(如类实例、字符串、数字),dict、list、自定义未实现 __hash__ 的类实例都会触发 TypeError: unhashable type。
- 适用场景:按实例缓存计算结果,比如
cache[instance] = expensive_result,实例销毁后缓存自动失效 - 注意
WeakKeyDictionary的键是弱引用,值是强引用 —— 如果值又反向引用了键,照样构成循环引用 - 若需弱引用值,得组合
WeakValueDictionary,但它的键是强引用,得看业务逻辑哪边更该“让步”
__del__ 和 weakref.callback 不要混用
注册 weakref.ref(obj, callback) 后,callback 在 obj 被垃圾回收时触发;而 __del__ 方法在实例即将销毁时调用。两者都可能执行,但顺序不确定,且 __del__ 本身容易引发问题(比如引用其他正在销毁的对象)。
- 优先用
weakref.ref+ callback,它更可控、无副作用,也不依赖 GC 时机 - 避免在 callback 里再创建新强引用指向原对象(比如存进全局 list),否则对象无法真正释放
-
__del__里不要调用涉及循环引用链上其他对象的方法 —— 它们可能已处于部分销毁状态,导致AttributeError或静默失败
asyncio 里 weakref 要小心事件循环生命周期
在异步代码中,如果用 weakref.ref 持有协程函数或 task 对象,要注意这些对象的生命周期由事件循环管理。task 被 cancel 或完成之后,即使没显式 await,也可能很快被回收,导致弱引用提前失效。
立即学习“Python免费学习笔记(深入)”;
- 典型坑:注册
weakref.ref(task, lambda r: print("done")),但 task 已结束、回调还没触发,r()就返回None - 更稳妥的做法是用
asyncio.create_task启动一个清理协程,在 task 完成后手动触发逻辑,而不是依赖弱引用回调 - 弱引用对
asyncio.Future有效,但对普通生成器或async def函数对象无效 —— 它们不是“可被弱引用的实例”
weakref 把那一端变成被动方。稍不注意,callback 里一行强引用、缓存里一个反向指针,就又绕回去了。


















