.NET MAUI返回无关页面时ApplyQueryAttributes仍被调用问题咨询

这是特性，不是Bug #

MAUI Shell的导航机制会复用页面实例并保留导航状态（包括查询参数）。当你从Page2通过GoToAsync("../../", parameters)返回Home时，Home页的实例已经被关联了这些参数；后续从Page3返回Home时，Shell会复用已存在的Home页实例，触发ApplyQueryAttributes()时会自动带上之前缓存的参数，这是Shell导航栈的设计特性。

解决方法 #

方法1：根据来源页面过滤参数 #

在Home页的ApplyQueryAttributes()中，判断上一页的类型，仅处理来自Page2的参数：

public override void ApplyQueryAttributes(IDictionary<string, object> query)
{
    // 获取导航栈中倒数第二个页面（即当前页面的上一页）
    if (Shell.Current.Navigation.NavigationStack.Count >= 2)
    {
        var previousPage = Shell.Current.Navigation.NavigationStack[^2];
        if (previousPage is Page2)
        {
            // 处理从Page2返回时携带的参数
            if (query.TryGetValue("YourParamKey", out var paramValue))
            {
                // 执行参数处理逻辑
            }
        }
        // 来自其他页面（如Page3）的情况，直接忽略参数
    }
}

方法2：处理完参数后清空缓存 #

在Home页中维护一个标记，处理完Page2的参数后清空查询字典，避免后续触发时重复处理：

private bool _hasProcessedPage2Params;

public override void ApplyQueryAttributes(IDictionary<string, object> query)
{
    if (!_hasProcessedPage2Params && query.ContainsKey("YourParamKey"))
    {
        // 处理参数逻辑
        _hasProcessedPage2Params = true;
        
        // 清空查询字典，移除所有缓存的旧参数
        foreach (var key in query.Keys.ToList())
        {
            query.Remove(key);
        }
    }
    else
    {
        // 忽略旧参数，调用基类方法时传递空字典
        base.ApplyQueryAttributes(new Dictionary<string, object>());
    }
}

方法3：重写Page3的返回逻辑 #

如果默认返回按钮的行为不符合预期，可以在Page3中重写返回事件，直接调用PopAsync()返回，确保不携带历史参数：

protected override bool OnBackButtonPressed()
{
    // 直接弹出栈顶页面，回到Home
    Shell.Current.Navigation.PopAsync();
    return true; // 阻止默认返回行为
}

另外，也可以通过修改标题栏返回按钮的点击事件实现相同逻辑：

public Page3()
{
    InitializeComponent();
    // 重写标题栏返回按钮行为
    NavigationPage.SetBackButtonTitle(this, "返回");
    var backButton = new ToolbarItem
    {
        Text = "返回",
        IconImageSource = "back_icon.png"
    };
    backButton.Clicked += async (s, e) => await Shell.Current.Navigation.PopAsync();
    ToolbarItems.Add(backButton);
    // 隐藏默认返回按钮
    NavigationPage.HasBackButton = false;
}

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