解决.NET MAUI Android后台服务依赖注入构造函数报错问题

错误原因 #

Android系统实例化Service类时，会强制调用公共无参构造函数，即使你定义了带参数的构造，系统也不会使用DI容器来创建实例，因此编译器会抛出XA4213错误，要求必须提供公共无参构造。

正确实现步骤 #

1. 调整AndroidBackgroundService代码 #

保留无参构造，移除带参数的构造，在服务启动后从MAUI的DI容器中获取依赖实例：

[Service]
public class AndroidBackgroundService : Service, IService
{
    private UpdateBackgroundService _updateBackgroundService;

    // 必须保留公共无参构造，供Android系统实例化
    public AndroidBackgroundService()
    {
    }

    public override IBinder OnBind(Intent intent)
    {
        throw new NotImplementedException();
    }

    [return: GeneratedEnum]
    public override StartCommandResult OnStartCommand(Intent intent, [GeneratedEnum] StartCommandFlags flags, int startId)
    {
        if (intent.Action == "START_SERVICE")
        {
            RegisterNotification();
            // 从DI容器获取服务实例（需配合MauiProgram的修改）
            using var scope = MauiProgram.Services.CreateScope();
            _updateBackgroundService = scope.ServiceProvider.GetRequiredService<UpdateBackgroundService>();
            Run();
        }
        else if (intent.Action == "STOP_SERVICE")
        {
            StopForeground(true);
            StopSelfResult(startId);
        }

        return StartCommandResult.NotSticky;
    }

    public void Run()
    {
        _updateBackgroundService?.Run();           
    }

    // 原有的Start、Stop、RegisterNotification方法保持不变
}

2. 完善MauiProgram配置 #

确保EF Core上下文工厂和服务正确注册，并暴露DI容器供后台服务调用：

var builder = MauiApp.CreateBuilder();

// 注册EF Core上下文工厂
builder.Services.AddDbContextFactory<Agent2DBContext>(options =>
{
    // 根据你的数据库类型配置连接字符串，示例为SQLite
    options.UseSqlite("Data Source=Agent2.db");
});

builder.Services.AddDbContextFactory<AsterixDBContext>(options =>
{
    options.UseSqlite("Data Source=Asterix.db");
});

// 注册业务服务
builder.Services.AddTransient<UpdateBackgroundService>();
#if ANDROID
builder.Services.AddTransient<AndroidBackgroundService>();
#endif

// 暴露DI容器，供后台服务获取实例
public static IServiceProvider Services { get; private set; }

var app = builder.Build();
Services = app.Services;
return app;

3. 关键说明 #

• 作用域管理：使用IServiceScopeFactory创建作用域，确保EF Core的DbContext等服务有正确的生命周期，避免长期持有导致的资源泄漏。
• 容器访问：通过MauiProgram.Services静态属性，让后台服务能访问MAUI的DI容器，获取所需的依赖实例。
• 服务注册：确保UpdateBackgroundService的所有构造参数（IServiceScopeFactory、IDbContextFactory）都已在DI容器中注册。

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