.NET MAUI应用中SQLite数据库初始化代码的正确放置位置

在ViewModel构造函数中通过Task.Run(...).GetAwaiter().GetResult()阻塞执行异步初始化的写法不符合开发规范，且在MAUI UI线程同步上下文下存在极高的死锁风险，容易导致应用启动白屏、无响应。以下是两种经过生产验证的正确实现方案，按推荐优先级排序：

方案1：应用启动阶段初始化（最推荐，全局仅执行一次） #

在MauiProgram.cs中完成DI容器构建后、应用首个页面加载前执行数据库初始化，这个阶段执行异步等待不会触发死锁，且能保证所有依赖IDbService的服务在被调用时，数据库已经完成初始化。
修改后的MauiProgram.cs核心代码如下：

// 原有DI注册逻辑保持不变
builder.Services
    .AddSingleton<IDbService>(serviceProvider => 
        ActivatorUtilities.CreateInstance<DbService>(serviceProvider, databasePath))
    .AddSingleton<MainViewModel>()
    .AddSingleton<MainPage>();

// 构建MauiApp实例
var app = builder.Build();

// 执行数据库初始化
using var scope = app.Services.CreateScope();
var dbService = scope.ServiceProvider.GetRequiredService<IDbService>();
await dbService.Initialise();
if (!(await dbService.GetExperiences(1, 0)).Any())
{
    await dbService.LoadTestData();
}

return app;

如果默认的CreateMauiApp方法签名不支持async，可以直接在初始化位置使用.GetAwaiter().GetResult()，这个阶段还没有进入UI线程同步上下文，不会产生死锁问题。

方案2：ViewModel异步生命周期初始化（适合需要绑定初始化数据的场景） #

如果初始化逻辑和页面强绑定、需要在初始化完成后立刻刷新页面绑定数据，不要把逻辑塞在构造函数里，而是给ViewModel增加专门的异步初始化方法，配合页面生命周期调用：

1. 重构ViewModel，构造函数只保留依赖注入赋值逻辑，所有异步逻辑移入独立初始化方法：

public class MainViewModel
{
    private readonly IDbService _dbService;

    // 构造函数仅做依赖赋值，不执行任何业务逻辑
    public MainViewModel(IDbService dbService)
    {
        _dbService = dbService;
    }

    public async Task InitializeAsync()
    {
        await _dbService.Initialise();
        if (!(await _dbService.GetExperiences(1, 0)).Any())
        {
            await _dbService.LoadTestData();
        }
        await GetData();
    }
}

2. 在对应页面的后台代码中，重写OnAppearing生命周期方法，增加单次执行标记，避免重复触发初始化：

public partial class MainPage : ContentPage
{
    private bool _hasInitialized;
    public MainPage(MainViewModel viewModel)
    {
        InitializeComponent();
        BindingContext = viewModel;
    }

    protected override async void OnAppearing()
    {
        base.OnAppearing();
        // 单例ViewModel仅初始化一次
        if (_hasInitialized) return;
        _hasInitialized = true;

        // 可按需在此处弹出加载提示
        await ((MainViewModel)BindingContext).InitializeAsync();
        // 初始化完成后关闭加载提示
    }
}

注意事项 #

• 禁止在UI线程关联的类（页面、ViewModel、UI控件）的构造函数中使用.Result、GetAwaiter().GetResult()阻塞异步代码，必然存在死锁风险
• 单例服务的初始化不需要额外加锁，上述两种方案都能保证初始化逻辑全局仅执行一次
• 如果数据库初始化耗时较长，优先选择方案2，配合加载态UI提示可以获得更好的用户体验，避免启动阶段长时间无响应

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