Prism Xamarin Forms中ToolbarItem重复显示问题求助

开发者阿泽

2026-5-19

解决Prism + Xamarin Forms中导航导致ToolbarItem重复的问题

嘿，刚接触Prism和Xamarin Forms遇到这种导航问题很正常，我来帮你理清原因和解决办法！

你遇到的ToolbarItem重复问题，核心原因是导航方式不对：当你调用NavigationService.NavigateAsync("Navigation/Partner")时，相当于在你的MasterDetailPage的Detail区域又新建了一个NavigationPage，而如果你的Home页面的Detail本身已经是一个NavigationPage（这是MasterDetail的常规配置），就会出现两层NavigationPage叠加，它们的Toolbar自然就重复显示了。

下面是具体的解决步骤：

第一步：确认Home页面的结构
首先检查你的Home（MasterDetailPage）的初始化代码，确保Detail已经是一个NavigationPage，比如：
```
public HomePage()
{
    InitializeComponent();
    // 把初始页面包裹在NavigationPage里作为Detail
    Detail = new NavigationPage(new DashboardPage());
}
```
这是MasterDetailPage的标准配置，后续的页面导航都会在这个Detail的NavigationPage里进行。
第二步：修正导航命令
点击Partner菜单项时，不需要再加上Navigation/前缀，直接导航到目标页面即可：
```
// 原来的写法（导致重复）
// await NavigationService.NavigateAsync("Navigation/Partner");

// 修改后的正确写法
await NavigationService.NavigateAsync("Partner");
```
Prism会自动识别当前Detail的NavigationPage，把Partner页面Push进去，不会重复创建NavigationPage，自然就不会有ToolbarItem重复的问题了。
额外排查点
如果按照上面的方法还是有重复，那可以检查下Partner页面本身是否重复定义了ToolbarItem，或者有没有在导航时通过其他代码额外添加了Toolbar元素。另外，如果你需要在导航后替换或隐藏MasterDetail的Toolbar，可以通过Prism的导航事件（比如INavigationAware接口的方法）来动态控制。