.NET 8+EF Core 8+SQL Server 2022下ConnectionString未初始化报错求助

可能的原因与对应解决方法 #

1. EF Core迁移工具未正确加载配置文件 #

Package Manager Console执行Update-Database时，依赖启动项目的配置文件（如appsettings.json），如果工具无法定位到该文件，就会导致连接字符串未初始化。

解决步骤：

• 在Package Manager Console顶部的默认项目下拉框中，选择包含DbContext和迁移代码的项目；同时确保启动项目是包含appsettings.json的Web/API项目。
• 右键appsettings.json文件 → 属性 → 设置复制到输出目录为「如果较新则复制」或「始终复制」，确保配置文件能被工具读取到。

2. DbContext存在无参构造函数 #

如果你的AppDbContext定义了无参构造函数，EF Core迁移工具会优先直接实例化该类，而不会使用Program.cs中通过依赖注入配置的连接字符串，导致连接未初始化。

解决步骤：

• 直接移除AppDbContext的无参构造函数，强制工具使用依赖注入的配置方式。
• 若必须保留无参构造函数，可在构造函数内手动加载配置：

public AppDbContext()
{
    var config = new ConfigurationBuilder()
        .SetBasePath(Directory.GetCurrentDirectory())
        .AddJsonFile("appsettings.json")
        .Build();
    var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>();
    optionsBuilder.UseSqlServer(config.GetConnectionString("DefaultConnexion"));
    ((IDbContextOptionsBuilderInfrastructure)optionsBuilder).AddOrUpdateExtension(null);
}

3. 环境配置文件未被正确读取 #

若项目使用了多环境配置（如appsettings.Development.json），迁移工具可能默认读取生产环境的appsettings.json，而该文件中未配置连接字符串。

解决步骤：

• 执行命令时指定环境：Update-Database -Environment Development
• 检查对应环境的配置文件中是否存在DefaultConnexion连接字符串。

4. 连接字符串名称拼写不一致（二次确认） #

虽然你已验证名称，但可再次检查：确保Program.cs中GetConnectionString("DefaultConnexion")的名称与appsettings.json中的键完全一致（注意大小写、拼写，比如是否误写为DefaultConnection）。

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