MAUI中WeakReferenceMessenger多次触发致API重复调用问题求助

核心原因排查 #

你遇到的问题大概率是同一类型的ContentPage存在多个未被GC回收的实例，每个实例都注册了DragCompletedMessage的接收器，导致消息发送时多个实例同时响应，触发多次API调用。即使你在单个实例里做了isSlidingActivitiesStarted的判断，也只能控制当前实例的触发，其他存活的实例依然会执行API调用。

针对性解决方案 #

1. 严格绑定注册与注销的时机，确保实例唯一响应 #

将注册逻辑放在页面的OnAppearing方法中，注销逻辑放在OnDisappearing方法中，确保页面可见时才监听消息，不可见时立即取消监听：

protected override void OnAppearing()
{
    base.OnAppearing();
    WeakReferenceMessenger.Default.Register<DragCompletedMessage>(this, (recipient, message) =>
    {
        if (isSlidingActivitiesStarted)
        {
            isSlidingActivitiesStarted = false;
            // API Call
        }
    });
}

protected override void OnDisappearing()
{
    base.OnDisappearing();
    WeakReferenceMessenger.Default.Unregister<DragCompletedMessage>(this);
}

这样可以避免页面不可见时还能接收到消息，减少无效实例的响应。

2. 给消息添加唯一标识，确保同一操作只被处理一次 #

在DragCompletedMessage中添加一个唯一的操作ID（比如Guid），在ViewModel发送消息时生成这个ID，页面端维护一个已处理ID的集合，避免重复处理同一操作的消息：

// 定义消息类
public class DragCompletedMessage
{
    public Guid OperationId { get; set; } = Guid.NewGuid();
    // 其他消息属性
}

// 页面端处理逻辑
private HashSet<Guid> _processedOperationIds = new HashSet<Guid>();

WeakReferenceMessenger.Default.Register<DragCompletedMessage>(this, (recipient, message) =>
{
    if (isSlidingActivitiesStarted && _processedOperationIds.Add(message.OperationId))
    {
        isSlidingActivitiesStarted = false;
        // API Call
    }
});

HashSet.Add会自动判断ID是否已存在，返回false则跳过处理，确保同一操作的消息只会被处理一次，即使多个实例存在，也只有第一个实例会执行API调用。

3. 检查页面实例是否被重复创建 #

确认你的导航逻辑是否每次打开页面都创建了新的ContentPage实例（比如Navigation.PushAsync(new YourPage())）。如果是这种情况，旧的页面实例可能因为被导航栈引用或者其他隐式引用没有被GC回收，导致多个接收器存在。

可以尝试使用Shell的导航方式，或者确保页面实例在不需要时被正确释放，比如在导航回退时移除对页面的引用。

4. 使用带Token的注册方式，明确指定接收方 #

如果你的页面是多实例场景（比如多个相同页面同时存在），可以给注册和发送消息时指定唯一的Token，确保消息只发送给目标实例：

// 页面端注册时使用实例自身作为Token
WeakReferenceMessenger.Default.Register<DragCompletedMessage>(this, this, (recipient, message) =>
{
    if (isSlidingActivitiesStarted)
    {
        isSlidingActivitiesStarted = false;
        // API Call
    }
});

// ViewModel发送消息时指定目标实例的Token（需要持有页面实例的引用，或者通过其他方式传递Token）
WeakReferenceMessenger.Default.Send(new DragCompletedMessage(), targetPageInstance);

这种方式需要ViewModel能获取到目标页面的实例引用，适合页面和ViewModel绑定紧密的场景。

额外注意事项 #

• 确保注销逻辑执行的是同一实例的注册：如果Unregister时传入的实例和注册时的实例不是同一个，注销会失效。
• 避免在页面构造函数中注册消息：构造函数中注册的话，只要实例存在就会监听，容易导致多个实例同时接收消息。

内容的提问来源于stack exchange，提问作者Matthew Pans