.NET MAUI自定义启动页后禁止返回至启动页的实现方案

针对你在Android和WinUI平台遇到的登录页返回键回到Splash启动页的问题，以下是几种直接可行的解决方案：

方案1：跳转Login时清除导航栈（推荐） #

修改SplashViewModel.cs中的导航代码，直接操作Shell导航并清除历史记录，让Login成为导航栈的唯一初始页面：

public override async Task InitializeAsync()
{
    await IsBusyFor(
        async () =>
        {
            // 原有初始化逻辑保持不变...
            
            // 替换原导航代码，跳转到Login并清除历史
            await Shell.Current.GoToAsync("//Login", true);

            // 额外确保导航栈仅保留Login页面（防止残留）
            var navigationStack = Shell.Current.Navigation.NavigationStack;
            if (navigationStack.Count > 1)
            {
                for (int i = navigationStack.Count - 2; i >= 0; i--)
                {
                    Shell.Current.Navigation.RemovePage(navigationStack[i]);
                }
            }
        });
}

说明：

• //Login 使用绝对路由跳转，确保定位到Login页面
• 第二个参数true启用跳转动画（可根据需求改为false）
• 栈清理操作会移除Login之前的所有页面，此时点击返回键会直接退出应用

方案2：拦截Login页面的返回键（平台特定处理） #

如果方案1无法生效，可直接在Login页面拦截返回键事件，强制退出应用：

修改LoginView.xaml.cs #

public partial class LoginView : ContentPage
{
    public LoginView(LoginViewModel viewModel)
    {
        InitializeComponent();
        BindingContext = viewModel;
    }

    // 处理Android物理返回键
    protected override bool OnBackButtonPressed()
    {
        Application.Current.Quit();
        return true; // 标记事件已处理，不再传递
    }

    // 处理WinUI窗口返回按钮
#if WINDOWS
    protected override void OnHandlerChanged()
    {
        base.OnHandlerChanged();
        if (Handler is Microsoft.Maui.Platform.WindowHandler windowHandler)
        {
            var appWindow = windowHandler.PlatformView;
            appWindow.BackRequested += (sender, args) =>
            {
                args.Handled = true; // 阻止默认返回行为
                Application.Current.Quit();
            };
        }
    }
#endif
}

方案3：调整初始化逻辑，将Splash作为临时任务载体 #

修改AppShell的初始化流程，让Splash仅执行后台任务，不进入导航栈，完成后直接设置Login为根页面：

修改AppShell.xaml.cs #

protected override async void OnHandlerChanged()
{
    base.OnHandlerChanged();
    if (Handler is not null)
    {
        // 直接获取SplashViewModel执行初始化任务，无需导航到Splash页面
        var splashVm = Microsoft.Maui.MauiProgram.Services.GetRequiredService<SplashViewModel>();
        await splashVm.InitializeAsync();
        
        // 清空导航栈并跳转到Login
        Shell.Current.Navigation.NavigationStack.Clear();
        await Shell.Current.GoToAsync("//Login");
    }
}

注意：此方案需要移除_navigationService.InitializeAsync()中导航到Splash的逻辑（如果存在）。

验证效果 #

完成任意一种修改后，在Android和WinUI平台测试：

1. 应用启动后显示Splash完成初始化
2. 跳转到Login页面后，点击返回键直接退出应用，不会回到Splash

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