EF Core报错：System.InvalidOperationException上下文实例重复操作排查

1. 中间件生命周期不匹配导致DbContext被复用 #

默认情况下，ASP.NET Core中间件是Singleton生命周期。如果在中间件的构造函数中注入DbContext（即使DbContext配置为Transient），中间件会长期持有这个DbContext实例，导致多个请求共用同一个上下文触发并发操作错误。

错误示例：

public class DataFetchMiddleware
{
    private readonly RequestDelegate _next;
    private readonly DatabaseContext _dbContext; // Singleton中间件持有Transient实例

    public DataFetchMiddleware(RequestDelegate next, DatabaseContext dbContext)
    {
        _next = next;
        _dbContext = dbContext;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        var data = await _dbContext.Users.ToListAsync();
        await _next(context);
    }
}

修正方案：在InvokeAsync方法中注入DbContext，而非构造函数：

public class DataFetchMiddleware
{
    private readonly RequestDelegate _next;

    public DataFetchMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    // 每次请求都会获取新的DbContext实例
    public async Task InvokeAsync(HttpContext context, DatabaseContext dbContext)
    {
        var data = await _dbContext.Users.ToListAsync();
        await _next(context);
    }
}

2. 异步操作未正确等待引发并行执行 #

代码中存在未await的异步调用，会导致同一个DbContext同时执行多个操作。

错误示例：

// 未等待第一个操作完成就启动第二个
var task1 = _dbContext.Users.ToListAsync();
var task2 = _dbContext.Roles.ToListAsync();
// 直接访问Result会阻塞线程，且两个操作并行触发上下文并发
var users = task1.Result;

修正方案：使用Task.WhenAll等待所有并行操作完成：

var task1 = _dbContext.Users.ToListAsync();
var task2 = _dbContext.Roles.ToListAsync();
await Task.WhenAll(task1, task2);

var users = task1.Result;
var roles = task2.Result;

3. 手动创建DbContext实例并复用 #

即使DI配置了Transient，若代码中手动new DbContext且复用该实例，也会触发并发错误。

错误示例：

// 手动创建的实例被用于多个异步操作
var dbContext = new DatabaseContext();
var usersTask = dbContext.Users.ToListAsync();
// 前一个操作未完成就启动第二个
var rolesTask = dbContext.Roles.ToListAsync();

修正方案：每个操作使用独立的DbContext实例：

using var userDbContext = new DatabaseContext();
var users = await userDbContext.Users.ToListAsync();

using var roleDbContext = new DatabaseContext();
var roles = await roleDbContext.Roles.ToListAsync();

4. 服务依赖链中的生命周期冲突 #

如果Singleton服务直接依赖Transient的DbContext，Singleton会长期持有DbContext实例，导致多请求复用。

错误示例：

// Singleton服务注入Transient DbContext
builder.Services.AddSingleton<UserService>(sp => 
    new UserService(sp.GetRequiredService<DatabaseContext>())
);

修正方案：通过IServiceScopeFactory在方法内创建作用域获取DbContext：

public class UserService
{
    private readonly IServiceScopeFactory _scopeFactory;

    public UserService(IServiceScopeFactory scopeFactory)
    {
        _scopeFactory = scopeFactory;
    }

    public async Task<List<User>> GetUsers()
    {
        using var scope = _scopeFactory.CreateScope();
        var dbContext = scope.ServiceProvider.GetRequiredService<DatabaseContext>();
        return await dbContext.Users.ToListAsync();
    }
}

5. 延迟加载触发的隐式并发查询 #

启用延迟加载后，若在异步操作完成后访问导航属性，可能在非原始线程触发额外查询，引发上下文并发。

错误示例：

var user = await _dbContext.Users.FirstOrDefaultAsync(u => u.Id == 1);
// 延迟加载导航属性，此时可能和之前的异步操作冲突
var orders = user.Orders.ToList();

修正方案：使用Include提前加载导航属性：

var user = await _dbContext.Users.Include(u => u.Orders)
                                 .FirstOrDefaultAsync(u => u.Id == 1);
var orders = user.Orders.ToList();

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