.NET7+EF Core执行Update-Database报错：ConnectionString未初始化

核心错误原因 #

你遇到的The ConnectionString property has not been initialized错误，主要由以下代码问题导致：

1. DbContext构造函数不匹配 #

ProjectContext类的构造函数存在名称和泛型参数错误：

// 错误：构造函数名小写（projectContext），泛型参数为DataContext而非ProjectContext
public projectContext(DbContextOptions<DataContext> options)
    : base(options)
{
}

该错误会导致依赖注入无法识别正确的带参构造函数，转而调用无参构造函数，触发后续错误的配置逻辑。

2. OnConfiguring中Configuration未正确加载 #

直接在OnConfiguring里新建ConfigurationManager，无法自动加载Web项目的appsettings.json，导致获取的连接字符串为空：

IConfiguration _config = new ConfigurationManager();
optionsBuilder.UseSqlServer(_config.GetConnectionString("customSectionConnectionStringName"));

3. 依赖注入注册类型不匹配 #

你在ConfigureServices中注册的DataContext与实际使用的ProjectContext类型不匹配，导致依赖注入失效：

// 错误：注册的DataContext与实际DbContext类不符
services.AddDbContext<DataContext>(options => options.UseSqlServer(_config.GetConnectionString("customSectionConnectionStringName")));

分步解决步骤 #

步骤1：修复DbContext构造函数 #

修改ProjectContext的构造函数，确保名称和泛型参数与类名一致，并优化OnConfiguring逻辑：

public class ProjectContext : DbContext
{
    // 移除无参构造函数，强制依赖注入使用带参构造
    // public ProjectContext() { }

    // 修正构造函数：名称大写，泛型参数为ProjectContext
    public ProjectContext(DbContextOptions<ProjectContext> options)
        : base(options)
    {
    }

    // 仅当未通过DI配置时才执行本地配置（避免覆盖DI的设置）
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        if (!optionsBuilder.IsConfigured)
        {
            // 指定Web项目路径加载配置，仅用于本地测试场景
            IConfiguration config = new ConfigurationBuilder()
                .SetBasePath(Path.Combine(Directory.GetCurrentDirectory(), "../Web"))
                .AddJsonFile("appsettings.json")
                .Build();
            optionsBuilder.UseSqlServer(config.GetConnectionString("customSectionConnectionStringName"));
        }
        base.OnConfiguring(optionsBuilder);
    }

    // 所有DbSet定义...
}

步骤2：修正依赖注入注册 #

在Web项目的ConfigureServices中，注册正确的ProjectContext类型：

// 确保_config是从Web项目配置中注入的（比如通过构造函数获取IConfiguration）
services.AddDbContext<ProjectContext>(options => 
    options.UseSqlServer(_config.GetConnectionString("customSectionConnectionStringName")));

步骤3：指定迁移项目执行命令 #

由于迁移文件生成在Infrastructure项目，执行Update-Database时需明确指定项目和启动项目：

Update-Database -Project Infrastructure -StartupProject Web -Verbose

该命令会让EF Core使用Web项目的配置文件获取连接字符串。

额外验证点 #

• 确认Infrastructure引用Core项目，Web项目同时引用Core和Infrastructure项目。
• 检查appsettings.json中customSectionConnectionStringName的格式是否完整（需包含数据库名、身份验证信息等）。
• 确保Web项目是当前启动项目，且appsettings.json的“复制到输出目录”设置为“始终复制”或“如果较新则复制”。

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