如何解决EF Core迁移时ConnectionString属性未初始化错误？

连接字符串配置（appsettings.json） #

"ConnectionString": {
    "DefaultConnectionString": "Data Source = DESKTOP-M39ULR1\\SQLEXPRESS;Initial Catalog = BanglaRunnersDb; Integrated Security=True;TrustServerCertificate=True"
}

DbContext注册代码 #

builder.Services.AddDbContext<ApplicationDbContext>(options =>
{
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnectionString"));
});

遇到的错误 #

1. 执行Add-Migration "Initial Migration"时，报错：

Unable to create a 'DbContext' of type ''.

2. 将DbContext注册代码移至var app = builder.Build();之前后，Add-Migration可正常执行，但执行Update-Database时，报错：

The ConnectionString property has not been initialized.

原因 #

1. 最初Add-Migration失败，是因为EF Core迁移工具无法在builder.Build()之后的代码中找到DbContext的注册逻辑，导致无法初始化DbContext实例。
2. 移到builder.Build()之前后，迁移工具能识别DbContext注册，但Update-Database报错，核心问题有两个可能：
   • DbContext构造函数未正确依赖注入配置，存在无参构造函数导致EF无法获取连接字符串；
   • 配置节点名称与GetConnectionString方法的默认读取节点不匹配，导致连接字符串读取失败。

解决方案 #

1. 修正DbContext构造函数 #

确保ApplicationDbContext仅保留依赖注入的构造函数，移除无参构造函数（避免EF Core使用无参构造路径而无法获取连接字符串）：

public class ApplicationDbContext : DbContext
{
    // 仅保留依赖注入构造函数
    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options)
    {
    }
}

2. 修正配置节点或读取方式 #

builder.Configuration.GetConnectionString()默认读取复数形式的ConnectionStrings节点，而你的配置是单数ConnectionString，这会导致读取失败。有两种解决方式：

• 修改appsettings.json的节点名称为复数：

"ConnectionStrings": {
    "DefaultConnectionString": "Data Source = DESKTOP-M39ULR1\\SQLEXPRESS;Initial Catalog = BanglaRunnersDb; Integrated Security=True;TrustServerCertificate=True"
}

• 或者直接通过配置路径读取连接字符串：

builder.Services.AddDbContext<ApplicationDbContext>(options =>
{
    var connectionString = builder.Configuration["ConnectionString:DefaultConnectionString"];
    options.UseSqlServer(connectionString);
});

3. 显式指定迁移的项目（可选） #

如果上述方法无效，在Package Manager Console中执行命令时显式指定启动项目和数据项目：

Update-Database -Project 你的DbContext所在项目名 -StartupProject 包含appsettings.json的Web项目名

内容的提问来源于stack exchange，提问作者Anam Mofazzal Durjoy