MAUI Shell代码注册非可见导航路由报错，求排查及替代方案

<TabBar>
    <ShellContent
        Title="ItemPage"
        ContentTemplate="{DataTemplate local:ItemPage}"
        Route="ItemPage" />
</TabBar>

``` 已经试过的操作： - 把注册和导航的路由文本全转小写 - 注册路由时给名称加`//`前缀

疑问 #

1. 我用Routing.RegisterRoute(nameof(ItemPage), typeof(ItemPage))代码注册路由的方式是否有误？
2. 如果MAUI确实存在这个问题，有没有不用在Shell菜单显示的页面路由注册替代方案？

环境：

• Visual Studio 2022 v17.4.3
• MAUI v7

---

1. 代码注册路由的问题 #

你代码里的注册逻辑本身没问题，问题出在导航时用的//前缀。//代表绝对路由，要求目标页面必须在Shell的层级结构（比如TabBar、FlyoutItem）里有对应的ShellContent/ShellSection/ShellItem。而通过Routing.RegisterRoute注册的是全局路由，不属于Shell的层级结构，所以用//ItemPage这种绝对路由格式会找不到匹配项。

正确的做法是去掉//前缀，用相对路由或者全局路由的专属格式（三个斜杠///）调用：

// 方式1：相对路由
string route = $"{nameof(ItemPage)}?{nameof(ItemPage.Id)}={itemVM.Id}";
await Shell.Current.GoToAsync(route);

// 方式2：全局路由（三个斜杠）
string route = $"///{nameof(ItemPage)}?{nameof(ItemPage.Id)}={itemVM.Id}";
await Shell.Current.GoToAsync(route);

另外要注意：MAUI Shell的路由名称区分大小写，用nameof(ItemPage)可以避免拼写不一致的问题。

2. 无需在Shell菜单显示的页面路由方案 #

针对这种不需要在Shell菜单展示的页面，有两种可靠的实现方式：

方案一：全局路由（代码注册） #

继续用Routing.RegisterRoute注册路由，导航时使用相对路由或者三个斜杠的全局路由格式即可，如上面的代码示例。这种方式不需要修改XAML，完全通过代码控制，适合动态注册路由的场景。

方案二：XAML注册隐藏的ShellContent #

如果更习惯用XAML管理路由，可以把需要隐藏的页面注册到一个不可见的Shell容器里，比如创建一个IsVisible="False"的FlyoutItem：

<Shell ...>
    <!-- 你的现有Shell菜单结构 -->
    <TabBar>
        <!-- 已有的ShellContent -->
    </TabBar>

    <!-- 隐藏的路由注册项，不会在菜单显示 -->
    <FlyoutItem IsVisible="False">
        <ShellContent Route="ItemPage" ContentTemplate="{DataTemplate local:ItemPage}" />
    </FlyoutItem>
</Shell>

这种方式注册的路由属于Shell层级内的路由，导航时可以继续用//ItemPage的绝对路由格式，同时不会出现在Shell菜单中。

---

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