WeakEventManager通过弱引用管理事件订阅,防止页面因事件强引用滞留导致内存泄漏;其核心是自动清理无需手动解绑,适用于跨生命周期事件通信,而页面内控件事件则无需使用。

MAUI 中用 WeakEventManager(注意不是 WeakReferenceManager,后者并不存在于 .NET MAUI 官方 API)替代传统事件订阅,是防止页面/控件因事件强引用滞留导致内存泄漏的核心手段。关键不在“怎么加”,而在“不手动解绑也能自动清理”。
为什么 WeakEventManager 能防泄漏
普通事件订阅(如 button.Clicked += OnClick;)会让发布者(button)持有一个指向订阅者(比如某页的实例方法)的强引用。页面导航出栈后若未显式 -=,该页面仍被 button 持有,无法被 GC 回收。
WeakEventManager 内部用弱引用来持有事件处理者,即使页面已出栈、无其他引用,GC 仍可安全回收它——button 不会阻止页面销毁。
正确使用 WeakEventManager 的三步法
- 定义事件时,用
WeakEventManager管理,不要暴露 public event - 订阅写法统一为
eventManager.AddEventHandler(handler),而非+= - 取消订阅用
eventManager.RemoveEventHandler(handler);若忘记调用,也不影响内存释放(这是和传统方式的本质区别)
典型场景:自定义服务中的事件通信
比如一个图片加载服务,多个页面可能监听 ImageLoaded 事件:
public class ImageLoaderService
{
private readonly WeakEventManager _eventManager = new();
public event EventHandler ImageLoaded
{
add => _eventManager.AddEventHandler(value);
remove => _eventManager.RemoveEventHandler(value);
}
public void LoadImage(string url)
{
// ... 加载完成后触发
_eventManager.HandleEvent(this, new ImageLoadedEventArgs(url), nameof(ImageLoaded));
}
}
页面中订阅无需担心生命周期匹配问题:
// 在 OnAppearing 中订阅即可,不用管 OnDisappearing 解绑 imageLoader.ImageLoaded += OnImageLoaded; // 即使没写 -=,页面 Pop 后也会被回收
哪些地方必须用,哪些可以不用
- 跨页面、跨服务、生命周期不一致的事件通信(推荐必用)
- 页面内控件事件(如 Button.Clicked)——不需要,因为控件与页面同生共死,无泄漏风险
- 静态类或单例中发布的事件(高危!必须用 WeakEventManager 或手动管理)
- Timer、BackgroundService 等长期运行对象触发的回调(建议用,避免持住页面实例)
基本上就这些。WeakEventManager 不是银弹,但它把“解绑遗漏”这个高频泄漏原因直接从开发清单里划掉了。









