ASP.NET Core应用与Worker Service中EF Core DbContext的最佳使用方式

绝对不要将DbContext注册为Singleton #

EF Core的DbContext是短生命周期设计，内部的ChangeTracker、数据库连接管理等组件均非线程安全。若注册为Singleton，会引发以下严重问题：

• 并发操作时实体跟踪状态混乱，导致数据错误或抛出异常
• ChangeTracker长期持有实体引用，引发内存泄漏
• 数据库连接无法及时释放，耗尽连接池资源

方案一：统一使用IDbContextFactory（推荐） #

将所有仓库的依赖统一改为IDbContextFactory<MyDbContext>，无论Web API（作用域环境）还是Worker Service（单例环境）都能兼容，代码实现完全一致。

统一仓库实现 #

// 替换原有RepoOne和RepoTwo的统一仓库
public class UnifiedRepo
{
    private readonly IDbContextFactory<MyDbContext> _factory;

    public UnifiedRepo(IDbContextFactory<MyDbContext> factory)
    {
        _factory = factory;
    }

    public async Task<bool> Any(int id)
    {
        using var myDbContext = await _factory.CreateDbContextAsync();
        return await myDbContext.MyTable.AnyAsync(m => m.Id == id);
    }
}

依赖注入配置 #

在基础设施层的DI配置中，仅注册IDbContextFactory即可：

// Program.cs 或DI配置类
builder.Services.AddDbContextFactory<MyDbContext>(options =>
{
    options.UseSqlServer("YourConnectionString");
});

这种方式的优势：

• 仓库代码完全统一，无需区分应用场景
• CreateDbContextAsync()自动管理DbContext生命周期，每次操作使用独立实例，避免线程安全问题
• 同时适配Web API请求作用域与Worker Service单例环境

方案二：在Worker Service中创建局部作用域（兼容现有RepoOne） #

若不想修改仓库依赖（继续直接注入MyDbContext），可在Worker的任务逻辑中创建局部作用域，从作用域内获取仓库实例，确保DbContext为作用域生命周期。

Worker Service修改示例 #

public class MyWorker : BackgroundService
{
    private readonly IServiceProvider _serviceProvider;

    public MyWorker(IServiceProvider serviceProvider)
    {
        _serviceProvider = serviceProvider;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            // 创建局部作用域
            using var scope = _serviceProvider.CreateScope();
            var repo = scope.ServiceProvider.GetRequiredService<RepoOne>();
            
            // 执行业务逻辑
            var exists = await repo.Any(1);
            
            await Task.Delay(TimeSpan.FromMinutes(1), stoppingToken);
        }
    }
}

依赖注入配置 #

保持Web API原有配置（注册作用域DbContext），确保Worker能访问DI容器：

// Program.cs
builder.Services.AddDbContext<MyDbContext>(options =>
{
    options.UseSqlServer("YourConnectionString");
}, ServiceLifetime.Scoped);

builder.Services.AddHostedService<MyWorker>();

这种方式的优势：

• 无需修改现有仓库代码，适配成本低
• 严格遵循DbContext生命周期设计，避免线程安全问题

总结 #

优先选择方案一，它能彻底统一仓库实现逻辑，符合DDD基础设施层的抽象设计，同时规避所有生命周期相关风险。方案二适合快速兼容现有代码的场景，但需注意在Worker中正确管理作用域的创建与释放。

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