MAUI迁移中Prism .CreateWindow()导航失败问题求助

核心问题根源 #

你遇到的Microsoft.Maui.Controls.InvalidNavigationException: No Root Window has been created是导航失败后的次生异常，真正的故障原因是DryIoc容器无法解析AppInitPageViewModel的依赖——从堆栈信息可以看到，容器尝试解析带Microsoft.Maui.Dispatching.Dispatcher参数的ViewModel时失败。

这是因为CreateWindow的设计定位是返回窗口的根页面实例，而非执行导航或依赖密集型初始化操作。对比OnAppStart，它是在窗口完全创建、平台服务（包括Dispatcher）就绪后才触发的；而CreateWindow阶段，MAUI的UI调度器尚未完成初始化，导致ViewModel依赖的Dispatcher无法被容器正确注入。

解决办法 #

方案1：遵循Prism MAUI生命周期规范（推荐） #

修改CreateWindow，直接返回根页面实例，将导航、AppCenter初始化等逻辑移到OnInitialized或页面的OnAppearing事件中：

.UsePrism(prism =>
    prism
    // ... 其他注册代码
    .OnInitialized(async _ =>
    {
        Microsoft.Maui.ApplicationModel.VersionTracking.Track();
        AppCenter.Start("android=guid;ios=guid", typeof(Analytics), typeof(Crashes));
        
        // 若需后续导航，在此处执行（此时窗口已创建，服务均就绪）
        var navigationService = App.Container.Resolve<INavigationService>();
        var result = await navigationService.NavigateAsync("/AppInitPage");
        if (!result.Success)
        {
            HandleNavigationError(result.Exception);
        }
    })
    .CreateWindow((container, navigation) =>
    {
        // 直接返回根页面，Prism会自动关联ViewModel
        return container.Resolve<AppInitPage>();
    })
);

方案2：临时兼容（不推荐，仅作应急） #

若必须在CreateWindow中执行逻辑，可提前向容器注册Dispatcher实例：
在RegisterTypes方法中添加：

// 仅在CreateWindow阶段临时注册Dispatcher，不推荐长期使用
containerRegistry.RegisterInstance(Microsoft.Maui.Dispatching.Dispatcher.GetForCurrentThread());

补充检查点 #

1. ViewModel依赖检查：确认AppInitPageViewModel的构造函数是否依赖Dispatcher（具体实现类），建议改用Prism提供的IDispatcher接口，Prism MAUI默认会自动注册该接口。
2. 初始化时机调整：将RegisterTypes中直接调用Resolve的代码（如App.Container.Resolve<IDb>().InitializeTables();）移到OnInitialized中，确保容器完全初始化后再执行服务初始化。

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