本文深入探讨了python对象内部属性（如列表）存储自身绑定方法时可能导致的循环引用问题，该问题会阻碍垃圾回收机制正常工作，进而引发内存泄漏。文章详细阐述了如何利用`weakref.weakmethod`创建弱引用，有效打破此类循环引用链，确保python对象能够在不再被强引用时被正确释放，从而优化内存管理。
在Python中，垃圾回收机制主要依赖引用计数来管理内存。当一个对象的引用计数降为零时，它通常会被回收。然而，当存在循环引用时，即使对象不再被外部代码使用，其引用计数也可能无法降为零，导致对象无法被回收，从而造成内存泄漏。一个常见的循环引用场景发生在对象内部存储其自身绑定方法时。
循环引用问题剖析
考虑以下Foo类示例，其some_func方法将自身的方法print_func添加到内部列表self.functions中：
import gc
class Foo():
def __init__(self):
self.functions = []
print('CREATE', self)
def some_func(self):
for i in range(3):
self.functions.append(self.print_func) # 存储绑定方法
print(self.functions)
def print_func(self):
print('I\'m a test')
def __del__(self):
print('DELETE', self)
# 示例操作
foo = Foo()
foo.some_func()
foo = Foo() # 创建新对象，旧对象应该被回收
# gc.collect() # 此时如果手动调用gc.collect()，旧对象才会被回收
input("Press Enter to exit...") # 保持程序运行以便观察运行上述代码，在不手动调用gc.collect()的情况下，会观察到如下输出：
CREATE <__main__.Foo object at 0x...> [<bound method Foo.print_func of <__main__.Foo object at 0x...>>, ...] CREATE <__main__.Foo object at 0x...> # 预期中的 'DELETE <__main__.Foo object at 0x...>' 消息并未出现
从输出中可以看出，第一个Foo对象在被新的Foo对象覆盖后，其__del__方法并未被调用，表明它没有被垃圾回收。这是因为self.functions列表存储了self.print_func方法。作为绑定方法，self.print_func隐式地持有一个对其所属实例self的强引用。因此，Foo对象通过self.functions引用了其方法，而其方法又反过来引用了Foo对象本身，形成了一个循环引用链。这个循环引用使得Foo对象的引用计数无法降为零，即使外部变量foo不再指向它。
立即学习“Python免费学习笔记（深入）”；
如果手动调用gc.collect()，则会强制执行垃圾回收，旧对象才会被删除：
CREATE <__main__.Foo object at 0x...> [<bound method Foo.print_func of <__main__.Foo object at 0x...>>, ...] CREATE <__main__.Foo object at 0x...> DELETE <__main__.Foo object at 0x...> # 手动回收后出现
虽然gc.collect()可以解决问题，但在实际应用中，我们通常希望垃圾回收机制能够自动、高效地工作，避免频繁或不必要的手动干预。
解决方案：使用 weakref.WeakMethod
为了打破这种循环引用，同时又能保留对方法的引用，Python提供了weakref模块。其中，weakref.WeakMethod是专门用于解决绑定方法循环引用的利器。WeakMethod会创建一个对绑定方法的弱引用，这意味着它不会增加被引用对象的引用计数。当被引用的对象没有其他强引用时，即使存在WeakMethod引用，对象仍然可以被垃圾回收。
当需要调用弱引用的方法时，必须先通过调用WeakMethod实例来获取实际的绑定方法，然后再调用该方法。如果原始对象已经被回收，WeakMethod将返回None。
实现细节与示例
以下是使用weakref.WeakMethod改进后的Foo类：
from weakref import WeakMethod
class Foo():
def __init__(self):
self.functions = []
print('CREATE', self)
def some_func(self):
for i in range(3):
self.functions.append(WeakMethod(self.print_func)) # 存储弱引用
print(self.functions)
def print_func(self):
print('I\'m a test')
def __del__(self):
print('DELETE', self)
# 示例操作
foo = Foo()
foo.some_func()
# 调用弱引用的方法：需要先解引用，再调用
if foo.functions[0](): # 检查弱引用是否仍然有效
foo.functions[0]()() # 调用实际方法
foo = Foo() # 创建新对象，观察旧对象是否被回收
input("Press Enter to exit...")运行上述修改后的代码，将得到以下输出：
CREATE <__main__.Foo object at 0x...> [<weakref at 0x...; to 'Foo' at 0x...>, <weakref at 0x...; to 'Foo' at 0x...>, <weakref at 0x...; to 'Foo' at 0x...>] I'm a test CREATE <__main__.Foo object at 0x...> DELETE <__main__.Foo object at 0x...>
可以看到，第一个Foo对象在第二个Foo对象创建后被成功回收，__del__方法被调用。这证明weakref.WeakMethod成功打破了循环引用。
代码解释：
- self.functions.append(WeakMethod(self.print_func)): 这里不再直接存储self.print_func这个绑定方法的强引用，而是存储了一个WeakMethod实例，它对self.print_func持有弱引用。
- foo.functions[0]()(): 要调用通过WeakMethod存储的方法，需要进行两次调用。第一次调用foo.functions[0]()会返回实际的绑定方法（如果对象尚未被回收），第二次调用()才是执行该方法。如果原始对象已被回收，foo.functions[0]()将返回None。因此，在调用前最好进行非空检查。
注意事项
- 调用方式: 务必记住WeakMethod的调用方式是weak_method_instance()()。第一次调用()是解引用，获取实际的绑定方法；第二次调用()才是执行该方法。
- 生命周期: 弱引用不会阻止对象的垃圾回收。一旦对象的所有强引用都消失，即使存在弱引用，对象也会被回收。此时，尝试解引用弱引用将返回None。
- 适用场景: weakref.WeakMethod特别适用于需要将对象自身方法存储在对象内部（或被对象间接持有）的场景，以避免意外的循环引用和内存泄漏。例如，事件处理器、回调函数列表等。
- 性能考量: weakref操作通常比直接的强引用稍有开销，但在解决内存泄漏问题方面，其收益远大于此。
总结
当Python对象内部属性需要存储其自身的绑定方法时，如果不加以注意，很容易形成循环引用，导致对象无法被垃圾回收，进而引发内存泄漏。weakref.WeakMethod提供了一个优雅且Pythonic的解决方案，通过创建对绑定方法的弱引用，有效地打破了这种循环引用链。理解并正确使用weakref.WeakMethod是编写健壮、高效Python代码的重要实践，尤其是在设计涉及回调或自引用结构的类时。
