DB Context无法获取正确连接串及EF迁移调试问题排查

核心原因分析 #

1. OnConfiguring不触发断点：当通过services.AddDbContext传入已配置的DbContextOptions时，EF Core会跳过OnConfiguring方法——因为上下文已经通过依赖注入获得了完整的配置，无需再执行该方法的逻辑。这是正常行为，不是bug。

2. DbContext无法获取连接字符串：

   • 你的StubsDBContext存在无参构造函数，EF迁移命令可能会调用这个构造函数实例化上下文，但该构造函数未初始化_configuration字段，导致OnConfiguring中_configuration为null，自然拿不到连接字符串。
   • 虽然你在AddInfrastructureServices中正确配置了连接字符串，但如果迁移过程中没有使用DI容器创建上下文，就会走无参构造的分支，导致配置失效。

具体修复方案 #

方案1：移除冗余的OnConfiguring逻辑（推荐） #

既然已经在DI配置中完成了数据库连接配置，直接删除OnConfiguring方法即可，避免逻辑冲突：

// 从StubsDBContext中移除以下方法
// protected override void OnConfiguring(DbContextOptionsBuilder options)
// {
//     var test2 = _configuration.GetConnectionString("DefaultConnection");
//     options.UseSqlServer(test2);
//     options.EnableSensitiveDataLogging();
// }

方案2：保留OnConfiguring但添加配置判断 #

如果需要保留OnConfiguring作为 fallback 逻辑，添加IsConfigured判断，仅在未配置时执行：

protected override void OnConfiguring(DbContextOptionsBuilder options)
{
    if (!options.IsConfigured)
    {
        // 手动加载配置（迁移场景下需要）
        var configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false)
            .Build();
            
        var connectionString = configuration.GetConnectionString("DefaultConnection");
        options.UseSqlServer(connectionString);
        options.EnableSensitiveDataLogging();
    }
}

方案3：添加DesignTimeDbContextFactory（用于调试迁移） #

创建设计时上下文工厂，让EF迁移命令使用你指定的配置创建上下文，同时支持断点调试：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
using Microsoft.Extensions.Configuration;
using System.IO;

public class StubsDBContextFactory : IDesignTimeDbContextFactory<StubsDBContext>
{
    public StubsDBContext CreateDbContext(string[] args)
    {
        // 加载配置，和程序运行时一致
        var configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json")
            .Build();

        var options = new DbContextOptionsBuilder<StubsDBContext>();
        options.UseSqlServer(configuration.GetConnectionString("DefaultConnection"));

        // 在这里加断点，或者在StubsDBContext的构造函数/OnConfiguring中加断点
        return new StubsDBContext(options.Options, configuration);
    }
}

添加这个类后，执行dotnet ef database update时，EF会自动使用该工厂创建上下文，此时可以在工厂或上下文的代码中设置断点调试。

额外优化点 #

1. 清理Program.cs中的冗余配置：你手动构建了_configuration，但builder.Configuration已经自动加载了appsettings.json，无需重复创建，删除以下冗余代码：

// 移除这段代码
// _configuration = new ConfigurationBuilder()
//    .SetBasePath(Directory.GetCurrentDirectory())
//    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
//    .Build();

直接使用builder.Configuration即可，比如var appSettingsSection = builder.Configuration.GetSection("AppSettings");。

2. 检查DbContext的GetConnectionString方法：该方法中return ConnectionStrings.DefaultConnection，如果ConnectionStrings不是已定义的静态类/常量，会导致编译错误，需确保该部分代码有效。

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