MAUI调用PopAsync()时出现路由匹配歧义错误求助

错误信息 #

System.ArgumentException: 'Ambiguous routes matched for: //D_FAULT_TabBar14/IMPL_BooksPage/BooksPage/D_FAULT_ModalReader16 matches found: //D_FAULT_TabBar14/IMPL_BooksPage/BooksPage/D_FAULT_ModalReader16,//D_FAULT_TabBar14/IMPL_BooksPage/BooksPage/D_FAULT_ModalReader16 (Parameter 'uri')'

相关配置与代码 #

TabBar配置 #

<TabBar
    Shell.NavBarIsVisible="False"
    Shell.TabBarBackgroundColor="{DynamicResource Background}"
    Shell.TabBarForegroundColor="{DynamicResource HighlightedItem}"
    Shell.TabBarTitleColor="{DynamicResource HighlightedItem}"
    Shell.TabBarUnselectedColor="{DynamicResource DarkerBackground}">
    <ShellContent
    Title="წიგნები"
    ContentTemplate="{DataTemplate pages:BooksPage}"
    Icon="open_book.svg"
    Route="BooksPage" />
......
</TabBar>

页面跳转代码 #

1. 从BooksPage跳转至ModalReader：

ModalReader mr = new ModalReader(book);
await Shell.Current.Navigation.PushAsync(mr, true);

2. 从ModalReader跳转至BookmarksModal：

BookmarksModal bm = new BookmarksModal(_viewModel.Book?.Title ?? "usaxelo", _viewModel.Sarchevi, (int x) =>
{
    Carousel.ScrollTo(x, animate: false);
});
await Shell.Current.Navigation.PushAsync(bm, true);

3. 触发异常的返回代码：

await Shell.Current.Navigation.PopAsync();

路由与依赖注入注册代码 #

1. AppShell中的路由注册：

public AppShell()
{
    InitializeComponent();

    Routing.RegisterRoute(nameof(Authenticator), typeof(Authenticator));
    Routing.RegisterRoute(nameof(MainPage), typeof(MainPage));
    Routing.RegisterRoute(nameof(LoginPage), typeof(LoginPage));
    Routing.RegisterRoute(nameof(BooksPage), typeof(BooksPage));
    //Routing.RegisterRoute(nameof(ReaderPage), typeof(ReaderPage));
    //Routing.RegisterRoute(nameof(ProfilePage), typeof(ProfilePage));
    //Routing.RegisterRoute("books/modalReader", typeof(ModalReader));
    //Routing.RegisterRoute("books/searchPage", typeof(BooksSeachPage));
    //Routing.RegisterRoute("books/reader/bookmarks", typeof(BookmarksModal));
    //Routing.RegisterRoute("books/reader/font", typeof(FontModal));
}

2. 依赖注入配置：

builder.Services.AddTransient<SessionManagement>();

builder.Services.AddSingleton<MainPage>();
builder.Services.AddSingleton<Authenticator>();
builder.Services.AddSingleton<LoginPage>();
builder.Services.AddSingleton<BooksPage>();
//builder.Services.AddTransient<ReaderPage>();
//builder.Services.AddTransient<ProfilePage>();
//builder.Services.AddTransient<ModalReader>();
//builder.Services.AddTransient<BookmarksModal>();
//builder.Services.AddTransient<FontModal>();

问题分析与解决方案 #

核心原因 #

路由歧义的本质是混合使用传统导航（PushAsync）和Shell路由系统，且未正确注册模态页面路由，导致Shell无法识别导航栈中页面的有效路由标识，只能生成D_FAULT_前缀的默认故障路由，当路由表出现重复条目时触发匹配异常。

解决步骤 #

1. 注册模态页面的Shell路由
   取消注释AppShell中的路由注册，确保路由层级与导航结构对应：

   public AppShell()
   {
       InitializeComponent();
   
       Routing.RegisterRoute(nameof(Authenticator), typeof(Authenticator));
       Routing.RegisterRoute(nameof(MainPage), typeof(MainPage));
       Routing.RegisterRoute(nameof(LoginPage), typeof(LoginPage));
       Routing.RegisterRoute(nameof(BooksPage), typeof(BooksPage));
       // 按导航层级注册模态页面路由
       Routing.RegisterRoute("BooksPage/ModalReader", typeof(ModalReader));
       Routing.RegisterRoute("BooksPage/ModalReader/BookmarksModal", typeof(BookmarksModal));
   }
   

2. 改用Shell标准导航方法跳转
   替换PushAsync为Shell的GoToAsync，通过路由跳转页面：

   • 从BooksPage跳转到ModalReader（可通过QueryProperty传递参数）：

     await Shell.Current.GoToAsync("ModalReader", new Dictionary<string, object> { { "Book", book } });
     

   • 从ModalReader跳转到BookmarksModal：

     await Shell.Current.GoToAsync("BookmarksModal", new Dictionary<string, object> { 
         { "Title", _viewModel.Book?.Title ?? "usaxelo" },
         { "Sarchevi", _viewModel.Sarchevi }
     });
     

   注：回调逻辑建议通过ViewModel事件、弱引用或注入服务传递，不要在路由参数中传递委托。

3. 调整模态页面的依赖注入生命周期
   模态页面需注册为Transient，保证每次打开都是新实例：

   builder.Services.AddTransient<ModalReader>();
   builder.Services.AddTransient<BookmarksModal>();
   

4. 使用Shell标准方法返回
   替换PopAsync为Shell的路由返回方式，让Shell自行管理导航栈：

   await Shell.Current.GoToAsync("..");
   

额外注意点 #

• 不要混合使用传统Navigation.PushAsync和ShellGoToAsync，会导致两个导航栈不一致，引发路由识别问题。
• 所有参与Shell导航的页面都必须注册路由，且路由层级要与实际导航结构匹配。

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