EF Core仅做只读查询用默认Scoped DbContext偶发多线程错误如何解决？

可行解决方案 #

1. 优先排查异步等待和依赖注入配置错误 #

• 检查所有EF仓储方法的调用位置，确保全部正确添加await关键字，未出现异步方法未等待就执行后续操作的情况。
• 排查仓储的注册生命周期：必须将通用仓储注册为Scoped，和DbContext的生命周期保持一致。如果仓储被错误注册为Singleton，会导致所有请求共享同一个DbContext实例，必然触发并发异常。
• 检查是否存在同一个请求内并行执行多个EF查询的逻辑（比如用Task.WhenAll同时调用多个仓储查询），同一个DbContext实例同一时间仅支持执行一个操作，并行查询会直接触发冲突。

2. 并行查询场景的适配 #

如果确实需要在单个请求内并行执行多个查询，不要直接复用当前Scope下的DbContext，为每个并行查询单独创建独立的IServiceScope，从新Scope中获取仓储实例执行查询，保证每个查询使用独立的DbContext。
示例代码：

using var scope1 = _serviceProvider.CreateScope();
var repo1 = scope1.ServiceProvider.GetRequiredService<IYourRepository>();
var task1 = repo1.GetAsNoTrackingAsync<Dto1>(x => x.Id == id1);

using var scope2 = _serviceProvider.CreateScope();
var repo2 = scope2.ServiceProvider.GetRequiredService<IYourRepository>();
var task2 = repo2.GetAsNoTrackingAsync<Dto2>(x => x.Id == id2);

await Task.WhenAll(task1, task2);

3. 官方推荐方案：使用IDbContextFactory #

EF Core 5及以上版本提供的IDbContextFactory是比直接修改DbContext为Transient更规范的解决方案，专门应对需要频繁创建、独立生命周期DbContext的场景：

1. 修改DbContext注册逻辑：

// 替换原有的AddDbContext，同时保留Scoped DbContext的注册兼容原有逻辑
services.AddDbContextFactory<MyContext>(options =>
{
    options.UseSqlServer(_configuration.GetConnectionString("DefaultConnection"),
    sqlServerOptionsAction: sqlOptions =>
    {
        sqlOptions.EnableRetryOnFailure(
        maxRetryCount: 10,
        maxRetryDelay: TimeSpan.FromSeconds(30),
        errorNumbersToAdd: null);
    });
}, ServiceLifetime.Scoped);
// 可选：如果还有其他逻辑依赖Scoped的DbContext，保留原有AddDbContext注册即可
services.AddScoped<MyContext>(sp => sp.GetRequiredService<IDbContextFactory<MyContext>>().CreateDbContext());

2. 调整仓储实现，每次查询从工厂获取独立的DbContext：

public class YourRepository<T> : IYourRepository<T>
{
    private readonly IDbContextFactory<MyContext> _contextFactory;

    public YourRepository(IDbContextFactory<MyContext> contextFactory)
    {
        _contextFactory = contextFactory;
    }

    public async Task<List<TDto>> GetAsNoTrackingAsync<TDto>(Expression<Func<T, bool>> predicate)
    {
        // 每次查询创建独立的DbContext，用完自动释放
        using var context = _contextFactory.CreateDbContext();
        return await context.Set<T>()
                     .AsNoTracking()
                     .Where(x => !x.IsDeleted)
                     .Where(predicate)
                     .OrderByDescending(e => e.RTime)
                     .ToListAsync();
    }
}

这个方案完全避免了同个DbContext被多个操作调用的问题，性能损耗极低，同时符合EF Core的最佳实践规范。

4. 开发环境增强错误排查 #

在开发环境下可以开启DbContext的线程安全检查，更早定位问题：

options.EnableThreadSafetyChecks();

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