EF Core 在 ASP.NET Core 中通过 DI 注册 DbContext 并构造注入使用,推荐在 Program.cs 用 AddDbContext 注册(Scoped 生命周期),控制器中注入后直接调用异步方法操作数据。

EF Core 在 ASP.NET Core 中通过依赖注入(DI)注册和使用 DbContext,这是官方推荐且最简洁的方式。核心思路是:在 Program.cs(或 Startup.cs)中将 DbContext 类型注册进 DI 容器,然后在控制器、服务等需要的地方通过构造函数注入即可。
在 Program.cs 中注册 DbContext
ASP.NET Core 6+ 推荐在 Program.cs 中配置服务:
- 使用 AddDbContext
() 方法注册 DbContext,并指定数据库提供程序和连接字符串 - 默认生命周期为 Scoped(每次 HTTP 请求创建一个实例),符合 DbContext 的设计原则
- 连接字符串通常从配置(如 appsettings.json)中读取
var builder = WebApplication.CreateBuilder(args);
// 从配置中读取连接字符串
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
// 注册 DbContext,使用 SQL Server
builder.Services.AddDbContext(options =>
options.UseSqlServer(connectionString));
var app = builder.Build();
在控制器中注入并使用 DbContext
注册后,直接在控制器构造函数中声明 DbContext 类型参数,框架会自动解析并传入实例:
- 无需手动 new 实例,也不用管理释放(DI 容器会在请求结束时自动释放 Scoped 实例)
- 确保 DbContext 属性为 private readonly,避免意外重新赋值
- 调用 SaveChangesAsync() 提交变更
public class ProductsController : ControllerBase
{
private readonly AppDbContext _context;
public ProductsController(AppDbContext context)
{
_context = context;
}
[HttpGet]
public async Task> Get()
{
return await _context.Products.ToListAsync();
}
}
自定义 DbContext 构造函数与依赖注入
如果 DbContext 需要额外依赖(如 ILogger 或 IOptions),可直接在构造函数中声明,DI 容器会一并解析:
- DbContext 构造函数参数必须都能被 DI 容器提供,否则启动失败
- 推荐将非必需依赖标记为可选(如用 ? 或 = null),或通过工厂模式解耦
- 避免在 DbContext 中注入 Scoped 以外的生命周期服务(如 Singleton 中持有 Scoped 实例会导致内存泄漏)
其他常见注册方式
根据场景可调整注册行为:
-
AddDbContextPool
() :启用上下文池,提升高并发下性能(适用于轻量、无状态操作) -
指定生命周期:如
AddDbContext(不推荐,易出错)(ServiceLifetime.Singleton) - 多 DbContext 场景:分别注册不同上下文,命名或使用泛型区分,注入时类型明确即可
基本上就这些。只要注册正确、注入自然、不手动管理生命周期,EF Core 和 ASP.NET Core 的配合非常顺滑。










