用 weakref.WeakSet 存储观察者可避免内存泄漏,因其自动清理已销毁对象;同步通知适合轻量回调,异步需谨慎处理线程安全与异常;singledispatch 实现类型驱动事件分发;禁止在回调中直接 unsubscribe,应延迟批量清理。

用 weakref 避免观察者内存泄漏
Python 中直接用列表存观察者引用,容易导致被观察对象生命周期被意外延长——尤其当观察者是类实例、而被观察者长期存活时。比如 GUI 组件注册了事件回调后被销毁,但观察者列表仍强引用它,就无法被 gc 回收。
正确做法是用 weakref.WeakSet 或 weakref.ref 存储观察者:
import weakref
<p>class EventManager:
def <strong>init</strong>(self):
self._observers = weakref.WeakSet() # 自动清理已销毁对象</p><pre class="brush:php;toolbar:false;">def subscribe(self, observer):
self._observers.add(observer) # 不会阻止 observer 被回收
def notify(self, event):
# WeakSet 迭代时自动跳过已被回收的对象
for obs in self._observers:
if hasattr(obs, 'on_event'):
obs.on_event(event)
-
WeakSet适合观察者是“可哈希对象”(如类实例),且不关心调用顺序 - 若需保持订阅顺序或支持函数式观察者,改用
[weakref.ref(cb) for cb in callbacks],迭代前先调用ref()检查是否还有效 - 别用
list+del手动清理——容易漏删或引发RuntimeError: Set changed size during iteration
区分同步通知与异步通知的触发时机
系统事件(如文件变化、网络响应)常要求“立刻响应”,但某些观察者逻辑可能耗时(如写日志到磁盘、发 HTTP 请求),阻塞主线程会拖慢整个事件流。
立即学习“Python免费学习笔记(深入)”;
默认应走同步通知;仅当明确需要解耦执行时才切到异步:
- 同步:直接在
notify()中遍历调用,简单可靠,适合轻量回调(如更新状态变量、触发信号) - 异步:用
threading.Thread或asyncio.create_task包裹单个观察者调用,但要注意线程安全(如共享数据需加锁)和异常吞没问题 - 避免在
notify()内部无条件启新线程——高频事件(如鼠标移动)会快速堆积线程,改用线程池或事件队列更稳妥
用 functools.singledispatch 支持多类型事件分发
系统事件种类多(FileCreatedEvent、NetworkTimeoutEvent、UserLoginEvent),如果每个都写 if/elif 判断类型,扩展性差且易出错。
推荐用单分派泛函数实现类型驱动分发:
from functools import singledispatch
<p>class EventManager:
def <strong>init</strong>(self):
self._handlers = {}</p><pre class="brush:php;toolbar:false;">@singledispatch
def handle(self, event):
raise NotImplementedError(f"Unhandled event type: {type(event)}")
@handle.register
def _(self, event: FileCreatedEvent):
for obs in self._observers:
obs.on_file_created(event.path)
@handle.register
def _(self, event: NetworkTimeoutEvent):
for obs in self._observers:
obs.on_network_timeout(event.host)
- 新增事件类型只需加一个
@handle.register方法,无需修改原有分支逻辑 - 注意
singledispatch只基于第一个参数类型分发,所以必须确保传入的是具体子类实例,而非基类或Any - 如果事件携带上下文需复用(如数据库连接),建议把 handler 方法抽成独立函数,由
EventManager统一注入依赖,而非塞进类里
避免在观察者中调用 unsubscribe() 引发的迭代异常
常见错误:某个观察者在 on_event() 里主动调用 unsubscribe(),而此时 notify() 正在遍历观察者列表——结果是 RuntimeError: Set changed size during iteration 或漏掉后续观察者。
- 最简方案:禁止在回调中直接取消订阅;改为抛出自定义异常(如
Raise UnsubscribeRequest),由notify()外层捕获并统一处理 - 更健壮做法:把“待移除列表”缓存在本次通知周期内,等遍历结束后再批量清理(
WeakSet本身不支持此模式,需换用普通容器 + 标记位) - 如果使用 asyncio,注意
async def on_event()中 await 的协程可能跨事件循环,unsubscribe()必须在同一线程/loop 中执行,否则引发RuntimeError: Task attached to a different loop
观察者模式真正难的不是注册和通知,而是生命周期管理和并发边界——这两点踩错一个,调试时往往表现为“有时生效有时不”,比逻辑错误更难定位。


















