.NET Core使用AddSingleton注册单例时注入DbContext报错如何解决

问题根因 #

默认AddDbContext会将EFContext注册为Scoped生命周期服务，而OPCClient是Singleton（单例）生命周期服务。ASP.NET Core 依赖注入规则禁止从根服务提供者（单例服务的所属容器）直接解析 Scoped 服务，因此抛出该异常。

解决方案 #

方案1（推荐）：注入IServiceScopeFactory按需创建 DbContext 作用域 #

该方案符合EF Core最佳实践，避免DbContext长期持有引发的并发、内存泄漏问题：

1. 修改OPCClient实现，构造函数接收IServiceScopeFactory，需要操作数据库时手动创建作用域获取EFContext：

public class OPCClient
{
    private readonly IServiceScopeFactory _scopeFactory;
    private readonly string _endpointURL;
    private readonly bool _autoAccept;
    private readonly int _stopTimeout;

    public OPCClient(string endpointURL, bool autoAccept, int stopTimeout, IServiceScopeFactory scopeFactory)
    {
        _endpointURL = endpointURL;
        _autoAccept = autoAccept;
        _stopTimeout = stopTimeout;
        _scopeFactory = scopeFactory;
    }

    // 示例：需要操作数据库的方法
    public void SaveDataToDb(object data)
    {
        // 创建独立作用域，用完自动释放
        using var scope = _scopeFactory.CreateScope();
        var efContext = scope.ServiceProvider.GetRequiredService<EFContext>();
        // 执行数据库操作
        efContext.Add(data);
        efContext.SaveChanges();
    }

    public void Run()
    {
        // 原有业务逻辑
    }
}

2. 修改ConfigureServices中的单例注册逻辑：

services.AddSingleton<OPCClient>(x =>
{
    string endpointURL = "opc.tcp://xxx.yyy.zzz.nnn:12345";
    bool autoAccept = false;
    int stopTimeout = Timeout.Infinite;
    // IServiceScopeFactory是单例生命周期，可以直接从根容器解析
    var scopeFactory = x.GetRequiredService<IServiceScopeFactory>();

    OPCClient client = new OPCClient(endpointURL, autoAccept, stopTimeout, scopeFactory);
    client.Run();
    return client;
});

方案2（不推荐，仅特殊场景使用）：修改DbContext生命周期为单例 #

如果业务必须让OPCClient长期持有同一个DbContext实例，且你能完全规避并发、内存泄漏风险，可以修改DbContext的注册配置：

// 显式指定EFContext的生命周期为Singleton
services.AddDbContext<EFContext>(options =>
{
    // 原有数据库连接配置
}, ServiceLifetime.Singleton);

修改后你原有的代码无需改动即可运行，但需要注意以下风险：

• DbContext不是线程安全的，多线程并发操作会引发不可预期的错误
• 长期不释放DbContext会导致跟踪的实体对象持续堆积，内存上涨
• 数据库连接异常会导致该单例DbContext永久失效，整个OPCClient都无法操作数据库

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