Xamarin Forms+Prism：MasterDetailPage切换页面时OnNavigatedTo调用两次

我之前在使用Prism开发Xamarin.Forms应用时，也碰到过类似的OnNavigatedTo被重复调用的问题，折腾了好几天才理清头绪。结合你的代码和现象，给你梳理几个排查方向和解决办法：

一、先确认问题本质：同一个实例被调用两次，还是创建了多个实例 #

首先在NewPageTestViewModel里加一行代码，输出实例的哈希值，判断问题根源：

public override void OnNavigatedTo(NavigationParameters parameters)
{
    base.OnNavigatedTo(parameters);
    Debug.WriteLine($"实例哈希: {this.GetHashCode()} - Calling twice HERE!");
}

• 如果输出的哈希值相同：说明是同一个ViewModel的OnNavigatedTo被触发了两次
• 如果哈希值不同：说明每次导航都创建了新的ViewModel实例，旧实例没被正确释放

二、针对「同一个实例被调用两次」的解决办法 #

这种情况通常是Prism在MasterDetailPage导航过程中，因导航状态变化触发了两次导航事件。你可以通过以下方式过滤重复调用：

1. 检查导航模式（NavigationMode）

Prism的NavigationParameters里会包含导航模式，你可以只处理需要的场景：

public override void OnNavigatedTo(NavigationParameters parameters)
{
    base.OnNavigatedTo(parameters);
    
    if (parameters.TryGetValue(NavigationParametersKeys.NavigationMode, out NavigationMode mode))
    {
        // 只处理首次进入（New）或返回（Back）的情况，过滤重复触发
        if (mode == NavigationMode.New || mode == NavigationMode.Back)
        {
            Debug.WriteLine("正常执行逻辑 HERE!");
            // 你的业务代码放在这里
        }
    }
}

2. 用标志位控制执行次数

如果导航模式无法区分，就手动加一个标志位，确保每次页面进入只执行一次逻辑：

private bool _hasNavigated = false;

public override void OnNavigatedTo(NavigationParameters parameters)
{
    base.OnNavigatedTo(parameters);
    
    if (_hasNavigated) return;
    
    _hasNavigated = true;
    Debug.WriteLine("只执行一次 HERE!");
    // 你的业务逻辑
}

public override void OnNavigatedFrom(NavigationParameters parameters)
{
    base.OnNavigatedFrom(parameters);
    // 离开页面时重置标志，下次进入重新执行
    _hasNavigated = false;
}

三、针对「创建多个ViewModel实例」的解决办法 #

这种情况大概率是你的导航方式有问题：每次选择菜单时都重新导航了整个PrincipalNavigationPage/{TargetPage}路径，导致Prism重复创建页面实例。

1. 使用绝对路径重置导航栈

登录后你已经初始化了/PrincipalMasterDetailPage/PrincipalNavigationPage/XXX的导航结构，后续切换菜单时，用绝对路径导航可以重置Detail的导航栈，避免重复创建实例：

// 替换原有的导航代码
await NavigationService.NavigateAsync($"/PrincipalMasterDetailPage/PrincipalNavigationPage/{item.TargetPageName}");

2. 使用相对路径导航

如果不想重置整个栈，只是替换当前页面，可以用相对路径导航：

// 回到PrincipalNavigationPage的根，再导航到目标页面
await NavigationService.NavigateAsync($"../{item.TargetPageName}", useModalNavigation: false);

四、其他排查点 #

1. 升级Prism版本：某些旧版本的Prism在MasterDetailPage导航逻辑上存在bug，升级到最新稳定版可能直接解决问题；
2. 检查MasterDetailPage的XAML：确保Detail区域的PrincipalNavigationPage是一次性初始化的，没有在每次切换菜单时重新创建；
3. 查看导航日志：在Prism的初始化代码中开启导航日志，帮助你理清导航过程：

// 在App.xaml.cs的OnInitialized方法里添加
Prism.Logging.Logger.Log += (s, e) => Debug.WriteLine($"[{e.Category}] {e.Message}");

内容的提问来源于stack exchange，提问作者Marcio E. H