Xamarin Forms GoToAsync返回按钮Android失效iOS正常

问题表现 #

• 执行GoToAsync页面导航时，iOS端全流程运行无异常
• Android端正向跳转可正常抵达目标页面，但点击导航栏内置返回按钮时直接抛出异常，无法返回上一页
• 错误信息提示存在歧义路由匹配，重复匹配到OpendaySessionsView路由
• 业务导航层级：OpenDaysPage -> OpendaySessionsView -> GenericMapWithWalkTime
• 触发条件：在OpendaySessionsView页面执行await Shell.Current.GoToAsync(nameof(GenericMapWithWalkTime))跳转至通用地图页后，Android端返回按钮立即失效

错误日志 #

[0:] Shell: Failed to Navigate Back: System.ArgumentException: Ambiguous routes matched for: //D_FAULT_FlyoutItem49/IMPL_OpenDaysPage/OpenDaysPage/OpendaySessionsView matches found: //D_FAULT_FlyoutItem49/IMPL_OpenDaysPage/OpenDaysPage/OpendaySessionsView,//D_FAULT_FlyoutItem49/IMPL_OpenDaysPage/OpenDaysPage/OpendaySessionsView
Parameter name: uri
  at Xamarin.Forms.ShellUriHandler.GetNavigationRequest (Xamarin.Forms.Shell shell, System.Uri uri, System.Boolean enableRelativeShellRoutes, System.Boolean throwNavigationErrorAsException, Xamarin.Forms.ShellNavigationParameters shellNavigationParameters) [0x000aa] in D:\a\1\s\Xamarin.Forms.Core\Shell\ShellUriHandler.cs:207 
  at Xamarin.Forms.ShellNavigationManager.GoToAsync (Xamarin.Forms.ShellNavigationParameters shellNavigationParameters) [0x000b8] in D:\a\1\s\Xamarin.Forms.Core\Shell\ShellNavigationManager.cs:44 
  at Xamarin.Forms.ShellSection+NavigationImpl.OnPopAsync (System.Boolean animated) [0x000e9] in D:\a\1\s\Xamarin.Forms.Core\Shell\ShellSection.cs:1061 
  at Xamarin.Forms.Platform.Android.ShellToolbarTracker.OnNavigateBack () [0x0002a] in D:\a\1\s\Xamarin.Forms.Platform.Android\Renderers\ShellToolbarTracker.cs:210 

问题相关代码 #

页面跳转逻辑 #

private async void ShowExibitorInfoCommandHandler(object obj)
{
    var loc = Startup.ServiceProvider.GetService<LocationRepository>();
    var locRes = GetBuildingInfo(77);

    if (locRes != null)
    {
        GenericMapWithWalkTime.LocationData = locRes;               
        await Shell.Current.GoToAsync(nameof(GenericMapWithWalkTime));
    }

    PopupService.GetOkPopupLayout("Visit Central Exhibition", "Don't forget to call into the Central Exhibition and speak to Academics and Students").Show();
}

原有路由注册代码 #

Routing.RegisterRoute(nameof(OpenDaysPage), typeof(OpenDaysPage));
Routing.RegisterRoute(nameof(OpendaySessionsView), typeof(OpendaySessionsView));
Routing.RegisterRoute(nameof(GenericMapWithWalkTime), typeof(GenericMapWithWalkTime));

根因分析 #

异常核心触发点是全局路由重复注册冲突：

• OpenDaysPage作为Shell定义的FlyoutItem/ShellSection层级页面，会被Shell自动注册为可视树层级路由
• 手动调用Routing.RegisterRoute再次将OpenDaysPage、OpendaySessionsView注册为同名全局路由后，路由表中会存在两条完全一致的OpendaySessionsView路由路径
• iOS端路由匹配逻辑容错性更高，不会触发重复路由校验；Android端执行返回导航时会做全路径精确匹配，直接抛出歧义匹配异常

修复步骤 #

1. 清理重复路由注册：删除Shell可视树中已存在页面的同名全局路由注册，仅对不在Shell默认层级中的页面注册全局路由。修正后的路由注册代码如下：

   // 移除OpenDaysPage、OpendaySessionsView的重复注册，两个页面已在Shell层级结构中被自动注册
   Routing.RegisterRoute(nameof(GenericMapWithWalkTime), typeof(GenericMapWithWalkTime));
   

2. 特殊场景兼容：如果OpendaySessionsView需要支持从非层级入口（比如启动页、通知点击）直接跳转，不要使用和类名完全一致的路由名注册全局路由，改用带唯一前缀的路由名避免冲突，示例：

   Routing.RegisterRoute("global/OpendaySessionsView", typeof(OpendaySessionsView));
   

3. 导航写法优化：沿Shell层级做相邻页面跳转时，优先使用相对路由前缀./，避免全局路由匹配优先级干扰，跳转代码修改为：

   await Shell.Current.GoToAsync($"./{nameof(GenericMapWithWalkTime)}");
   

开发规范提示：不要给已经在Shell.xaml中声明的ShellSection、ShellContent对应页面重复注册同名全局路由，这是Xamarin.Forms Shell三层及以上导航返回时歧义匹配异常的最常见诱因。

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