MAUI中OnNavigatedTo调用带///路由的GoToAsync抛异常问题

一、两种路由调用结果不同的原因 #

1. ///HomePage 抛出异常的原因 #

///HomePage 属于从当前位置向下搜索路由层级并替换导航栈内容的路由类型。你在OnNavigatedTo事件中调用该导航时，LoadingPage的导航流程本身仍在处理中（Shell导航栈处于未完成的pending状态），此时发起替换导航栈的操作会与当前未结束的导航冲突，因此抛出"pending navigations still processing"异常。

2. HomePage 脱离Shell上下文的原因 #

无前缀的HomePage属于从当前位置向上搜索路由层级并将页面入栈的相对路由。如果LoadingPage不是Shell路由体系的一部分（比如直接作为App的初始MainPage加载，而非通过Shell导航进入），导航HomePage时会将其加载到独立的导航栈中，完全脱离AppShell的层级结构，自然无法显示Shell定义的TabBar和侧边栏。

二、Shell路由类型说明（中文翻译） #

• 绝对URI：//animal/domestic/cat —— 从Shell根节点开始匹配完整路由路径
• 相对URI（"cat"）：从当前页面所在路由层级向上搜索，匹配后将页面入栈
• 相对URI（"/cat"）：从当前页面所在路由层级向下搜索，匹配后将页面入栈
• 相对URI（"//cat"）：从当前页面所在路由层级向上搜索，匹配后替换整个导航栈
• 相对URI（"///cat"）：从当前页面所在路由层级向下搜索，匹配后替换导航栈内容

三、正确的导航流程与代码示例 #

方案1：先完成身份验证再初始化Shell（推荐） #

将LoadingPage作为App启动时的临时页面，完成验证后再切换到AppShell，确保后续导航都在Shell体系内：

// App.xaml.cs
protected override Window CreateWindow(IActivationState activationState)
{
    return new Window(new LoadingPage());
}

// LoadingPage.xaml.cs
public LoadingPage()
{
    InitializeComponent();
    _ = AuthAndNavigate();
}

private async Task AuthAndNavigate()
{
    var isAuthenticated = await IsAuthenticated();
    
    if (isAuthenticated)
    {
        // 切换MainPage为AppShell，自动加载Shell的TabBar等组件
        Application.Current.MainPage = new AppShell();
        // 若HomePage是Shell的根路由项，可省略下面的导航，TabBar会默认显示第一个项
        await Shell.Current.GoToAsync("//HomePage");
    }
    else
    {
        // 若LoginPage已注册到Shell路由，直接用Shell导航
        await Shell.Current.GoToAsync(nameof(LoginPage));
        // 若LoginPage不在Shell路由中，可临时切换MainPage：
        // Application.Current.MainPage = new LoginPage();
    }
}

方案2：在OnNavigatedTo中延迟导航（适配LoadingPage已在Shell路由内的场景） #

如果LoadingPage本身是Shell路由的一部分，需等待当前导航完成后再发起新导航，可通过Dispatcher延迟执行：

protected override async void OnNavigatedTo(NavigatedToEventArgs e)
{
    base.OnNavigatedTo(e); // 先执行base方法，确保当前导航流程推进
    
    var isAuthenticated = await IsAuthenticated();
    if (isAuthenticated)
    {
        // 延迟到Dispatcher队列执行，等待当前导航栈处理完成
        await Dispatcher.DispatchAsync(async () =>
        {
            // 使用//HomePage从Shell根层级替换导航栈，确保关联Shell上下文
            await Shell.Current.GoToAsync("//HomePage");
        });
    }
    else
    {
        await Shell.Current.GoToAsync(nameof(LoginPage));
    }
}

前置条件：正确注册路由 #

确保在AppShell中注册相关页面路由：

// AppShell.xaml.cs
public AppShell()
{
    InitializeComponent();
    Routing.RegisterRoute(nameof(HomePage), typeof(HomePage));
    Routing.RegisterRoute(nameof(LoginPage), typeof(LoginPage));
}

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