EF Core 6如何让DBContext正确读取已配置的数据库连接字符串

这个报错的核心触发点是DbContext没有拿到有效的数据库提供程序配置，90%的场景是两个配置遗漏：

• 注册AddDbContext时没有指定对应数据库的提供程序扩展方法（比如UseSqlServer/UseMySql）
• 自定义DbContext类缺少接收DbContextOptions<你的DbContext类名>参数的构造函数，依赖注入容器传入的配置无法被上下文接收
  另外如果你是手动new DbContext()实例化而不是走依赖注入，也会触发这个错误。

1. 给DbContext补充依赖注入用的构造函数 #

打开你的DbContext类，添加如下构造函数，把AppDbContext替换成你自己的上下文类名：

public class AppDbContext : DbContext
{
    // 必须加这个构造函数，依赖注入会通过它传入配置
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options)
    {
    }

    // 保留你原有的DbSet属性定义即可
    // public DbSet<User> Users { get; set; }
}

如果是EF Core脚手架自动生成的DbContext，默认会生成无参构造+OnConfiguring硬编码连接串，你删掉硬编码内容后很容易漏掉这个带参数的构造函数，这是最高发的踩坑点。

2. 修正Program.cs中的DbContext注册逻辑 #

你已经从appsettings.json读取了连接字符串，但是注册DbContext时必须明确指定数据库提供程序，以SQL Server为例正确写法如下：

// 从配置文件读取连接字符串，对应appsettings.json里ConnectionStrings节点的配置
var connStr = builder.Configuration.GetConnectionString("DefaultConnection");
// 注册DbContext，必须调用对应数据库的Use扩展方法
builder.Services.AddDbContext<AppDbContext>(options =>
{
    // 不同数据库对应不同方法，需要提前安装对应Nuget包
    options.UseSqlServer(connStr); // SQL Server 用这个，需安装Microsoft.EntityFrameworkCore.SqlServer
    // options.UseMySql(connStr, ServerVersion.AutoDetect(connStr)); // MySQL用这个，推荐装Pomelo.EntityFrameworkCore.MySql
    // options.UseNpgsql(connStr); // PostgreSQL用这个，需安装Npgsql.EntityFrameworkCore.PostgreSQL
});

3. OnConfiguring方法的正确写法 #

不需要在OnConfiguring里重复写注入的配置，如果你要保留这个方法做本地调试兜底，可以加判断避免覆盖注入的配置：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    // 仅当没有外部传入配置时，才走本地兜底逻辑
    if (!optionsBuilder.IsConfigured)
    {
        // 本地开发/做EF迁移的时候可以在这里写临时连接串，生产环境不会走到这段逻辑
        // optionsBuilder.UseSqlServer("本地调试用的连接字符串");
    }
}

4. 注意实例化方式 #

后续使用DbContext必须通过依赖注入获取，不要手动调用无参构造函数new AppDbContext()，手动实例化的上下文不会拿到Program里注册的配置，依然会抛出同样的异常。正确使用示例：

// 在MVC控制器、Minimal API、自定义服务中通过构造函数注入
public class UserService
{
    private readonly AppDbContext _dbContext;
    // 依赖注入容器会自动传入配置好的DbContext实例
    public UserService(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    public async Task<List<User>> GetAllUsers()
    {
        return await _dbContext.Users.ToListAsync();
    }
}

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