MAUI Shell导航异常：ApplyQueryAttributes与页面生命周期时序问题

问题现象 #

导航路径：MainPage > PageA > PageB > PageWithFlyoutMenu

• 前两次常规导航（MainPage→PageA、PageA→PageB）的页面生命周期顺序：Constructor > ApplyQueryAttributes > OnAppearing > OnNavigatedTo
• 从PageB跳转至PageWithFlyoutMenu时，若先设置Shell.Current.FlyoutContent再调用GoToAsync，生命周期顺序变为：Constructor > OnAppearing > OnNavigatedTo > ApplyQueryAttributes，ApplyQueryAttributes被延迟至最后执行

相关配置与代码 #

AppShell XAML配置 #

<Shell
x:Class="****.AppShell"
xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:local="clr-namespace:****.Views"
xmlns:localDetail="clr-namespace:****.Views.DetailPages"
Title="****">

<ShellContent
    Title="MainPage"
    ContentTemplate="{DataTemplate local:MainPage}"
    FlyoutItemIsVisible="False"
    Route="MainPage"
    Shell.FlyoutItemIsVisible="False" />

<ShellContent
    Title="PageWithFlyoutMenu-1"
    ContentTemplate="{DataTemplate localDetail:PageWithFlyoutMenu-1}"
    Route="PageWithFlyoutMenu-1" />

<ShellContent
    Title="PageWithFlyoutMenu-2"
    ContentTemplate="{DataTemplate localDetail:PageWithFlyoutMenu-2}"
    Route="PageWithFlyoutMenu-2" />

</Shell>

路由注册代码 #

Routing.RegisterRoute("PageA", typeof(PageA));
Routing.RegisterRoute("PageB", typeof(PageB));

PageB的ApplyQueryAttributes实现 #

public override void ApplyQueryAttributes(IDictionary<string, object> query)
{
    Tracker.WriteLine();

    if (query.ContainsKey("MyDto"))
    {
        var myParameter = query["MyDto"] as MyDto;

        if (myParameter != null) MyId = new Guid(myParameter.MyId);
    }
    
    base.ApplyQueryAttributes(query);
}

异常原因解析 #

这个异常的核心是提前设置FlyoutContent打乱了Shell导航的默认生命周期调度逻辑：

1. 常规Shell导航流程中，调用GoToAsync后，Shell会先完成目标页面实例化（Constructor），随即传递查询参数并执行ApplyQueryAttributes，最后触发页面显示相关的生命周期方法（OnAppearing、OnNavigatedTo）。
2. 若在GoToAsync前先修改Shell.Current.FlyoutContent，Shell会优先处理侧边栏内容的加载与布局刷新——这一操作会触发Shell内部的状态重置，导致原本绑定在导航流程中的参数传递逻辑被延后。目标页面虽会被正常实例化，但ApplyQueryAttributes会被推迟到页面显示完成（OnAppearing、OnNavigatedTo执行完毕）后才触发。
3. PageWithFlyoutMenu是直接在AppShell中预注册的ShellContent，而非像PageA/PageB那样通过Routing.RegisterRoute动态注册。这种注册方式的差异会让Shell对页面的生命周期管理逻辑不同：动态路由页面的参数传递是导航核心步骤，而预注册的ShellContent页面在结合FlyoutContent变更操作时，Shell会优先保障UI状态更新，进而延后参数传递流程。

解决方案建议 #

• 调整执行顺序：将设置FlyoutContent的逻辑移至目标页面（PageWithFlyoutMenu）的OnNavigatedTo方法中，确保导航参数先通过ApplyQueryAttributes完成传递。
• 避免手动修改FlyoutContent：优先利用Shell原生的FlyoutItem配置管理侧边栏内容，减少对Shell内部状态的直接干预。

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