.NET MAUI中从模态弹窗导航失效问题求助

原因分析 #

问题出在模态页关闭后，当前导航上下文还未切换回主导航栈，直接在模态页ViewModel的NavigationService上执行PushAsync，操作的是已被销毁的模态页导航栈，所以目标页面不会显示。

可行解决方法 #

1. 切换到主导航栈执行Push操作 #

关闭模态页后，直接获取主页面的导航实例来推送账户页，避开模态页的导航上下文问题：

[RelayCommand]
async Task LoginSuccess()
{
    // 关闭登录模态页
    await NavigationService.PopModalAsync();
    // 获取主页面的导航栈
    var mainNav = App.Current.MainPage.Navigation;
    // 推送账户页
    if (mainNav != null)
    {
        await mainNav.PushAsync(new AccountPage());
    }
}

2. 使用消息通知主页面执行导航 #

通过Community Toolkit的WeakReferenceMessenger，让主页面的ViewModel来处理账户页的推送，彻底避免导航上下文冲突：

第一步：定义消息类

public class LoginCompletedMessage { }

第二步：登录ViewModel发送消息

[RelayCommand]
async Task LoginSuccess()
{
    await NavigationService.PopModalAsync();
    // 发送登录完成的消息
    WeakReferenceMessenger.Default.Send(new LoginCompletedMessage());
}

第三步：主页面ViewModel注册消息并处理导航

public class MainViewModel(INavigationService navigationService)
{
    private readonly INavigationService _navigationService = navigationService;

    public MainViewModel()
    {
        // 注册消息监听
        WeakReferenceMessenger.Default.Register<LoginCompletedMessage>(this, (sender, message) =>
        {
            _ = _navigationService.PushAsync(new AccountPage());
        });
    }
}

3. 确保异步操作回到UI线程 #

如果是异步上下文丢失导致的问题，在异步方法后添加ConfigureAwait(true)，确保操作回到UI线程执行：

[RelayCommand]
async Task LoginSuccess()
{
    await NavigationService.PopModalAsync().ConfigureAwait(true);
    await NavigationService.PushAsync(new AccountPage()).ConfigureAwait(true);
}

4. 检查导航服务实例的正确性 #

确认ViewModel中注入的INavigationService是主页面的导航实例，而非模态页的。如果用依赖注入，确保注册的是全局单例导航服务；或者在主页面ViewModel中持有正确的导航实例，通过参数传递给模态页ViewModel，让模态页关闭后调用主页面的导航方法。

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