Xamarin Forms迁移MAUI后Debug正常Release启动失败求助

核心问题是你的CreateWindow委托未返回任何Window实例，且错误地在窗口创建阶段执行异步导航逻辑——Debug模式下JIT编译的延迟掩盖了问题，但Release模式下AOT编译后直接触发了"No Root Window has been created"的导航异常。

以下是两种可行的修复方案：

方案一：在CreateWindow中返回窗口并延迟执行导航 #

修改MauiProgram.cs中的CreateWindow逻辑，先返回窗口实例，再在窗口加载完成后执行导航操作：

.CreateWindow((container, navigation) =>
{
    var window = container.Resolve<Window>();
    // 订阅窗口加载事件，确保窗口创建完成后再执行导航
    window.Loaded += async (sender, args) =>
    {
        try
        {
            if (VersionTracking.IsFirstLaunchEver && !AppConstants.IsLoggedInUser && !Convert.ToBoolean(await SecureStorage.GetAsync(AppConstants.ShowBiometricConsent).ConfigureAwait(false)))
            {
                AppConstants.IsLoggedInUser = true;
                SecureStorage.RemoveAll();
                await SecureStorage.SetAsync(AppConstants.LoggedIn, AppConstants.False);
                await SecureStorage.SetAsync(AppConstants.LoggedOut, AppConstants.True);
                await SecureStorage.SetAsync(AppConstants.ShowBiometricConsent, AppConstants.True);
                await SecureStorage.SetAsync(AppConstants.ShowNotificationOptions, AppConstants.True);

                await Theme.SetTheme();
                await ClearLoginCredentials();
                await navigation.NavigateAsync(AppConstants.LoginPage);
            }
            else
            {
                await Theme.SetTheme().ConfigureAwait(false);
                var isLoggedOut = Convert.ToBoolean(await SecureStorage.GetAsync(AppConstants.LoggedOut).ConfigureAwait(false));

                if (isLoggedOut)
                {
                    await ClearLoginCredentials();
                    await SecureStorage.SetAsync(AppConstants.LoggedIn, AppConstants.False).ConfigureAwait(false);
                    await navigation.NavigateAsync(AppConstants.LoginPage).ConfigureAwait(false);
                }
                else
                {
                    await navigation.NavigateAsync(AppConstants.MainPage).ConfigureAwait(false);
                }
            }
            Profile.ProfileImage = null;
            Barrel.ApplicationId = Configurations.ClientID;
        }
        catch (Exception ex)
        {
            Crashes.TrackError(ex);
        }
    };
    return window;
})

方案二：使用Prism标准初始化流程处理导航 #

更符合Prism架构规范的做法是，将导航逻辑移到App.xaml.cs的初始化方法中：

1. 先修改MauiProgram.cs的CreateWindow，仅返回默认窗口：

.CreateWindow((container, navigation) => container.Resolve<Window>())

2. 在App.xaml.cs中重写OnInitialized方法，执行导航逻辑：

protected override async void OnInitialized()
{
    InitializeComponent();

    try
    {
        if (VersionTracking.IsFirstLaunchEver && !AppConstants.IsLoggedInUser && !Convert.ToBoolean(await SecureStorage.GetAsync(AppConstants.ShowBiometricConsent).ConfigureAwait(false)))
        {
            AppConstants.IsLoggedInUser = true;
            SecureStorage.RemoveAll();
            await SecureStorage.SetAsync(AppConstants.LoggedIn, AppConstants.False);
            await SecureStorage.SetAsync(AppConstants.LoggedOut, AppConstants.True);
            await SecureStorage.SetAsync(AppConstants.ShowBiometricConsent, AppConstants.True);
            await SecureStorage.SetAsync(AppConstants.ShowNotificationOptions, AppConstants.True);

            await Theme.SetTheme();
            await ClearLoginCredentials();
            await NavigationService.NavigateAsync(AppConstants.LoginPage);
        }
        else
        {
            await Theme.SetTheme().ConfigureAwait(false);
            var isLoggedOut = Convert.ToBoolean(await SecureStorage.GetAsync(AppConstants.LoggedOut).ConfigureAwait(false));

            if (isLoggedOut)
            {
                await ClearLoginCredentials();
                await SecureStorage.SetAsync(AppConstants.LoggedIn, AppConstants.False).ConfigureAwait(false);
                await NavigationService.NavigateAsync(AppConstants.LoginPage).ConfigureAwait(false);
            }
            else
            {
                await NavigationService.NavigateAsync(AppConstants.MainPage).ConfigureAwait(false);
            }
        }
        Profile.ProfileImage = null;
        Barrel.ApplicationId = Configurations.ClientID;
    }
    catch (Exception ex)
    {
        Crashes.TrackError(ex);
    }
}

额外检查项 #

• 确保使用的Prism.Maui版本与当前MAUI版本兼容，建议升级到最新稳定版
• 检查Release模式编译设置：iOS若开启AOT需确认Prism支持；Android若开启R8混淆，需添加Prism和MAUI的混淆规则
• 验证SecureStorage在Release模式下的权限配置（比如iOS的Keychain Sharing权限、Android的相关存储权限）

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