MAUI返回按钮在多层页面导航时失效问题求助

问题现象 #

使用MAUI App.Shell开发时，遇到多级导航返回按钮失效问题：

• Page1→Page2：左上角返回按钮、Android物理返回键均正常工作
• Page2→Page3：两种返回方式全部失效

已尝试多种导航写法（Shell路由导航、PushAsync、带/不带斜杠），页面和ViewModel均已在Program.cs注册，路由也在AppShell中完成注册。

解决方案 #

1. 统一使用Shell路由导航，避免混合导航方式

不要同时混用Shell.Current.Navigation.PushAsync和Shell路由导航（GoToAsync），Shell的导航栈管理依赖自身路由系统，混合使用会导致栈状态混乱。

修改ViewModel中的导航命令，统一使用GoToAsync：

// ViewModel1
[RelayCommand]
public async Task GoToPage2()
{
    await Shell.Current.GoToAsync(nameof(Page2));
}

// ViewModel2
[RelayCommand]
public async Task GoToPage3() // 替换async void为async Task，避免异步状态丢失
{
    await Shell.Current.GoToAsync(nameof(Page3));
}

2. 正确注册Shell嵌套路由

Shell需要明确的路由层级来管理导航栈，注册路由时需体现页面的导航关系：

public AppShell()
{
    InitializeComponent();

    // 注册层级路由
    Routing.RegisterRoute(nameof(Page1), typeof(Page1));
    Routing.RegisterRoute($"{nameof(Page1)}/{nameof(Page2)}", typeof(Page2));
    Routing.RegisterRoute($"{nameof(Page1)}/{nameof(Page2)}/{nameof(Page3)}", typeof(Page3));
}

3. 通过依赖注入获取ViewModel，禁止手动实例化

手动new ViewModel()会绕过MAUI的依赖注入容器，导致页面与ViewModel的绑定状态异常，进而影响导航栈的识别。

修改页面构造函数，通过构造注入获取ViewModel：

// Page2.xaml.cs
public Page2(ViewModel2 viewModel)
{
    InitializeComponent();
    BindingContext = viewModel;
}

// Page3.xaml.cs
public Page3(ViewModel3 viewModel)
{
    InitializeComponent();
    BindingContext = viewModel;
}

4. 检查弹出菜单的导航逻辑

如果问题仅在从弹出菜单进入Page2后出现，需确保弹出菜单的导航方式不会重置Shell的导航栈。例如，避免使用GoToAsync("//Page2")（双斜杠表示绝对根路由），改用相对导航或确保Page2是当前栈的子页面。

验证步骤 #

1. 清理项目并重新生成
2. 从Page1导航到Page2，再到Page3
3. 测试左上角返回按钮和Android物理返回键是否正常工作

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