使用secrets.json配置连接字符串，执行dotnet ef migrations命令报connectionString为空

排查与修复步骤 #

• 指定启动项目（多项目场景必做）：如果是多项目解决方案，执行迁移命令时必须指定包含配置的启动项目，否则无法读取secrets.json。命令示例：

  dotnet ef migrations add init -o Migrations --startup-project ../你的Web项目路径
  

• 确认secrets.json绑定的项目：右键包含DbContext的项目→「管理用户机密」，检查打开的secrets.json是否是你配置连接字符串的那个文件——用户机密是和单个项目绑定的，选错项目就会读不到配置。
• 检查DbContext的配置逻辑：确保DbContext正确加载用户机密，示例代码：

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      if (!optionsBuilder.IsConfigured)
      {
          var config = new ConfigurationBuilder()
              .SetBasePath(Directory.GetCurrentDirectory())
              .AddUserSecrets<你的DbContext类名>() // 必须指定当前DbContext的类型
              .Build();
          optionsBuilder.UseSqlServer(config.GetConnectionString("你的连接字符串键名"));
      }
  }
  

• 核对连接字符串键名：secrets.json中的连接字符串键名（如"ConnectionStrings": {"MyDb": "xxx"}）和代码中GetConnectionString传入的名称必须完全一致，大小写敏感。
• 清理缓存重建项目：删除项目下的bin和obj文件夹，重启Visual Studio后重新生成项目，避免配置缓存导致的读取异常。

.NET 6+顶级语句场景补充 #

如果使用Program.cs顶级语句，需确保启动项目中已正确注册DbContext并加载配置：

builder.Services.AddDbContext<你的DbContext类名>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("你的连接字符串键名")));

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