MAUI应用启动时基于异步条件检查实现Shell路由跳转的方案

一、首选入口：Shell的Navigating事件 #

Shell自带的Navigating事件是处理导航前异步校验的最佳位置——它能拦截所有Shell发起的导航请求，不管是全局校验还是特定页面的权限检查都适用。

实现步骤： #

1. 在AppShell.xaml.cs的构造函数里订阅Navigating事件
2. 在事件处理方法中执行异步检查（比如验证登录状态、权限等）
3. 根据检查结果，要么放行原导航，要么取消原请求并跳转到目标路由

示例代码：

public partial class AppShell : Shell
{
    public AppShell()
    {
        InitializeComponent();
        Navigating += AppShell_Navigating;
    }

    private async void AppShell_Navigating(object sender, ShellNavigatingEventArgs e)
    {
        // 只拦截需要校验的目标路由，比如带权限的页面
        if (e.Target.Location.OriginalString == "//MainPage/ProtectedPage")
        {
            // 执行异步检查逻辑，比如查本地存储或调API验证登录
            bool isLoggedIn = await CheckUserLoginStatusAsync();

            if (!isLoggedIn)
            {
                // 取消原本的导航请求
                e.Cancel();
                // 跳转到登录页
                await Shell.Current.GoToAsync("//LoginPage");
                return;
            }
        }
    }

    // 模拟异步检查方法，实际替换成你的业务逻辑
    private Task<bool> CheckUserLoginStatusAsync()
    {
        return Task.FromResult(false);
    }
}

二、灵活方案：封装自定义导航服务 #

如果需要把校验逻辑分散到ViewModel中，或者需要更灵活的导航控制，可以封装一个自定义导航服务，在发起导航前先完成异步检查。

示例代码：

public class NavigationService
{
    public async Task NavigateWithCheckAsync(string targetRoute)
    {
        // 先做异步校验
        bool hasPermission = await CheckUserPermissionAsync();

        if (hasPermission)
        {
            await Shell.Current.GoToAsync(targetRoute);
        }
        else
        {
            await Shell.Current.GoToAsync("//PermissionDeniedPage");
        }
    }

    // 自定义权限校验逻辑
    private Task<bool> CheckUserPermissionAsync()
    {
        return Task.FromResult(false);
    }
}

在ViewModel中调用：

public class HomeViewModel
{
    private readonly NavigationService _navService;

    public HomeViewModel(NavigationService navService)
    {
        _navService = navService;
        GoToSettingsCommand = new Command(async () => await _navService.NavigateWithCheckAsync("//SettingsPage"));
    }

    public ICommand GoToSettingsCommand { get; }
}

三、关键注意点 #

• 用e.Cancel()取消原导航时，一定要确保后续的跳转逻辑正常执行，避免出现导航阻塞
• 异步操作无需额外切换线程，MAUI的await会自动回到主线程处理UI相关操作
• 如果是页面级的事后校验，也可以在目标页面的OnAppearing方法里做，但这种方式无法拦截导航，适合做二次校验

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