在MauiProgram.cs中执行异步数据库操作的最佳方法咨询

你需要在MauiProgram.cs中执行创建管理员用户这类异步数据库操作，现有代码虽能运行，但存在不少可优化的点，先看你当前的实现：

public static MauiAppBuilder SqlLiteInitializer(this MauiAppBuilder mauiAppBuilder)
{
    var sqlLite = mauiAppBuilder.Services.BuildServiceProvider().GetRequiredService<ISqlLite<UserModel>>();

    Task.Run(() => sqlLite.CreateOrUpdateTableAsync()).Wait();
}

当前实现的问题 #

1. 服务实例不一致：调用BuildServiceProvider()会创建一个独立的服务容器，和最终builder.Build()生成的应用服务容器不是同一个，可能导致数据库连接等服务实例重复或状态不一致。
2. 主线程阻塞：Task.Run(...).Wait()会强制阻塞主线程，初始化耗时较长时，会导致应用启动界面卡顿，甚至存在死锁风险。

最优实现方案：使用Hosted Service #

利用.NET的IHostedService（后台服务）来执行异步初始化操作，这是官方推荐的应用启动阶段执行后台任务的方式，优势在于支持异步、不阻塞主线程、符合依赖注入规范。

步骤1：创建数据库初始化后台服务

public class DatabaseInitializerHostedService : IHostedService
{
    private readonly ISqlLite<UserModel> _sqlLite;

    // 通过依赖注入获取数据库服务实例
    public DatabaseInitializerHostedService(ISqlLite<UserModel> sqlLite)
    {
        _sqlLite = sqlLite;
    }

    public async Task StartAsync(CancellationToken cancellationToken)
    {
        // 执行表创建/更新操作
        await _sqlLite.CreateOrUpdateTableAsync();
        
        // 在这里添加其他异步初始化逻辑，比如创建管理员用户
        await CreateAdminUserIfNotExistsAsync();
    }

    public Task StopAsync(CancellationToken cancellationToken)
    {
        return Task.CompletedTask;
    }

    // 示例：检查并创建管理员用户
    private async Task CreateAdminUserIfNotExistsAsync()
    {
        // 假设ISqlLite有ExistsAsync方法用于判断用户是否存在
        var adminExists = await _sqlLite.ExistsAsync(u => u.IsAdmin);
        if (!adminExists)
        {
            await _sqlLite.InsertAsync(new UserModel 
            { 
                Username = "admin", 
                PasswordHash = "你的加密密码", 
                IsAdmin = true 
            });
        }
    }
}

步骤2：在MauiProgram中注册服务

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
        });

    // 注册你的ISqlLite实现
    builder.Services.AddScoped<ISqlLite<UserModel>, SqlLiteImplementation>();
    // 注册初始化后台服务
    builder.Services.AddHostedService<DatabaseInitializerHostedService>();

    return builder.Build();
}

方案优势 #

• 依赖注入规范：通过构造函数注入获取服务实例，和应用运行时使用的是同一个服务容器，避免实例不一致问题。
• 无阻塞启动：异步执行初始化逻辑，不会阻塞应用主线程，启动体验更流畅。
• 逻辑解耦：初始化逻辑独立封装在Hosted Service中，代码更易维护和扩展。

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