EF Core 的
DbContext默认不是线程安全的,不能在多个线程间共享同一个实例。强行共用会直接抛出
InvalidOperationException,比如 “A second operation was started on this context instance before a previous operation completed”。解决的核心思路就一个:**让每个线程拥有自己独立的 DbContext 实例**。
每个线程创建独立的 DbContext 实例
这是最直接、最推荐的做法。不依赖外部容器,也不跨线程传递上下文。
在Task.Run、
async方法或后台任务内部,用
new MyDbContext(options)创建新实例 务必配合
using或
Dispose()确保及时释放连接和资源 适合控制权明确的场景,比如定时任务、并行处理一批数据
示例:
public async Task ProcessBatchAsync(List{
using var context = new AppDbContext(_options);
var items = await context.Items.Where(x => ids.Contains(x.Id)).ToListAsync();
// 处理逻辑...
}
用 IServiceScopeFactory 创建作用域
在 ASP.NET Core 依赖注入环境中,
DbContext默认注册为 Scoped 生命周期。多线程下不能直接用注入的实例,但可以通过作用域工厂动态创建新作用域。 注入
IServiceScopeFactory(而非
IServiceProvider,后者可能已释放) 每次进线程都调用
scopeFactory.CreateScope(),再从中获取
DbContext作用域自动管理生命周期,避免手动释放遗漏
示例:
private readonly IServiceScopeFactory _scopeFactory;public MyService(IServiceScopeFactory scopeFactory) => _scopeFactory = scopeFactory;
public async Task RunInParallel()
{
var tasks = Enumerable.Range(0, 5).Select(i =>
Task.Run(async () =>
{
using var scope = _scopeFactory.CreateScope();
var ctx = scope.ServiceProvider.GetRequiredService();
await ctx.Users.AddAsync(new User { Name = $"User{i}" });
await ctx.SaveChangesAsync();
}));
await Task.WhenAll(tasks);
}
使用 IDbContextFactory(EF Core 5.0+ 推荐)
这是专为多线程/长生命周期场景设计的工厂接口,比手动 new 或作用域更轻量、更语义清晰。
注册时用AddDbContextFactory<t>()</t>,它本身是 Singleton 每次需要时调用
factory.CreateDbContext(),返回全新、干净的实例 无需管理作用域,也无 DI 容器释放风险,特别适合 Worker Service 或非 Web 场景
注册与使用:
// Program.csservices.AddDbContextFactory(opt =>
opt.UseSqlServer(Configuration.GetConnectionString("Default")));
// 使用处
private readonly IDbContextFactory _factory;
public Handler(IDbContextFactory factory) => _factory = factory;
public async Task Handle()
{
using var ctx = await _factory.CreateDbContextAsync();
await ctx.Logs.AddAsync(new Log { Msg = "Done" });
await ctx.SaveChangesAsync();
}
绝对要避开的坑
这些做法看似省事,实际隐患极大:
不要把 Scoped 的 DbContext 注入到 Singleton 类里——会导致上下文跨请求复用、连接泄漏 不要用 lock / SemaphoreSlim 包裹 DbContext 操作——虽能“跑通”,但彻底丧失并发能力,且容易死锁 不要在异步方法中用普通lock——它会阻塞线程池线程,破坏异步优势 不要试图复用已 Dispose 的 DbContext——会抛出
ObjectDisposedException
基本上就这些。关键不是“怎么加锁”,而是“怎么隔离”。只要守住“一任务一上下文”这条线,EF Core 在多线程下就很稳。
