.NET MAUI Shell导航栈始终仅含空项，返回功能失效求助

问题描述 #

创建了默认MAUI Shell应用，包含主页及三个子页面，启用Flyout菜单，Shell XAML代码如下：

<ShellContent
    Title="Home"
    ContentTemplate="{DataTemplate local:MainPage}"
    Route="MainPage" />

<ShellContent
    Title="Page 1"
    ContentTemplate="{DataTemplate local:Page1}"
    Route="Page1" />

<ShellContent
    Title="Page 2"
    ContentTemplate="{DataTemplate local:Page2}"
    Route="Page2" />

<ShellContent
    Title="Page 3"
    ContentTemplate="{DataTemplate local:Page3}"
    Route="Page3" />

通过Flyout菜单依次导航至Page1、Page2、Page3后，在Page3中检查Shell.Current.Navigation.NavigationStack.Count()始终返回1且条目为空；调用await Shell.Current.GoToAsync("..")也无法返回上一页，需要正常使用导航栈功能。

核心原因 #

MAUI Shell中，直接通过ShellContent定义的Flyout菜单条目，本质是根页面切换——这种操作不会将页面添加到传统的导航栈（NavigationStack），而是替换当前显示的根页面。因此导航栈中始终只有当前根页面，甚至因为Shell的导航机制封装，会出现栈条目为空的情况；而GoToAsync("..")是针对导航栈的返回操作，没有栈条目自然无法生效。

你看到的相关结论是正确的：默认的ShellContent根页面切换确实无法生成可返回的导航栈。

解决方法 #

要实现带返回功能的导航栈，需要改变页面的导航方式，避免直接切换根ShellContent，而是通过导航到子页面的方式将页面加入栈：

方法1：修改路由结构，将页面作为主页的子路由 #

调整Shell的XAML结构，把需要保留导航栈的页面嵌套在主页的层级下：

<FlyoutItem Title="Home">
    <ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage">
        <ShellContent ContentTemplate="{DataTemplate local:Page1}" Route="Page1" />
        <ShellContent ContentTemplate="{DataTemplate local:Page2}" Route="Page2" />
        <ShellContent ContentTemplate="{DataTemplate local:Page3}" Route="Page3" />
    </ShellContent>
</FlyoutItem>

之后通过代码导航到子页面（比如在主页或Flyout菜单点击事件中）：

// 从主页导航到Page1，会将Page1加入导航栈
await Shell.Current.GoToAsync("Page1");

方法2：用MenuItem替代ShellContent，通过点击事件导航 #

在Flyout中使用MenuItem而非ShellContent，点击时触发导航操作：

<FlyoutItem Title="Menu">
    <MenuItem Text="Home" Clicked="HomeMenuItem_Clicked" />
    <MenuItem Text="Page 1" Clicked="Page1MenuItem_Clicked" />
    <MenuItem Text="Page 2" Clicked="Page2MenuItem_Clicked" />
    <MenuItem Text="Page 3" Clicked="Page3MenuItem_Clicked" />
</FlyoutItem>

后台代码处理点击事件：

private async void HomeMenuItem_Clicked(object sender, EventArgs e)
{
    // 导航回主页，清空栈
    await Shell.Current.GoToAsync("//MainPage");
}

private async void Page1MenuItem_Clicked(object sender, EventArgs e)
{
    // 导航到Page1，加入导航栈
    await Shell.Current.GoToAsync("Page1");
}

// Page2、Page3的点击事件类似

方法3：自定义Flyout导航逻辑 #

如果需要保留原有的ShellContent显示样式，可在FlyoutItem的点击事件中拦截，判断当前页面后选择导航方式：

// 假设通过Shell的ItemSelected事件处理
private async void Shell_ItemSelected(object sender, SelectedItemChangedEventArgs e)
{
    if (e.SelectedItem is ShellContent content)
    {
        var currentRoute = Shell.Current.CurrentState.Location.OriginalString;
        if (currentRoute != content.Route)
        {
            // 导航到目标页面，加入栈
            await Shell.Current.GoToAsync(content.Route);
        }
    }
}

内容的提问来源于stack exchange，提问作者George M Ceaser Jr