ASP.NET Core 7中ConnectionString未初始化异常排查求助

问题现象 #

调试时抛出异常：

System.InvalidOperationException: The ConnectionString property has not been initialized.
不调试时应用仅显示无数据，该功能在其他项目可正常运行，迁移至当前项目后出现问题。

核心原因分析 #

从提供的代码来看，配置结构与读取方式不匹配是主要问题：

• Program.cs中使用builder.Configuration.GetConnectionString("QA_Context")读取连接字符串，该方法默认读取配置文件中ConnectionStrings节点下的键值对。
• 但appsettings.json中把QA_Context放在了ConnectionStringQA节点下，导致无法正确读取到连接字符串，进而引发DbContext初始化失败。

解决步骤 #

1. 修正配置文件结构（推荐） #

修改appsettings.json，将连接字符串移至标准的ConnectionStrings节点下：

{
  "ConnectionStrings": {
    "DefaultConnection": "你的Default数据库连接字符串",
    "QA_Context": "Data Source=foo.bar.local;Initial Catalog=foo_qa;Integrated Security=True;TrustServerCertificate=True;MultipleActiveResultSets=true;Encrypt=True"
  }
}

2. 若需保留原有节点结构，调整读取方式 #

如果必须保留ConnectionStringQA节点，修改Program.cs中的DbContext注册代码，指定正确的配置路径：

builder.Services.AddDbContext<QSCC_QAContext>(options =>
    options.UseSqlServer(builder.Configuration.GetSection("ConnectionStringQA")["QA_Context"]));

3. 清理DbContext的无参构造函数 #

当前QSCC_QAContext存在无参构造函数，若代码中存在手动调用该构造函数的场景（如反射、手动实例化），会导致连接字符串未初始化。建议移除无参构造函数，仅保留依赖注入用的带参构造函数：

namespace QsccDevAlpha.Data;

public partial class QSCC_QAContext : DbContext
{
    public QSCC_QAContext(DbContextOptions<QSCC_QAContext> options)
        : base(options)
    {
    }

    public virtual DbSet<AssetsByAssociate> AssetsByAssociate { get; set; }
}

4. 验证连接字符串加载（调试用） #

在Program.cs中添加输出，确认连接字符串是否正确读取：

var qaConnStr = builder.Configuration.GetConnectionString("QA_Context");
Console.WriteLine($"QA_Context连接字符串：{qaConnStr}");

调试时查看控制台输出，若为空则说明配置仍未正确读取。

额外排查点 #

• 检查环境配置文件：确认appsettings.Development.json等环境特定配置文件未覆盖或缺失连接字符串配置。
• 排查依赖注入：确保控制器中仅通过构造函数注入QSCC_QAContext，无手动实例化的代码。
• 数据库权限验证：确认应用运行用户（如IIS应用池账户）具有目标数据库的访问权限，避免因权限问题导致无数据。

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