ASP.NET Core Razor Pages：初始化字符串格式不符合规范错误排查求助

核心问题定位 #

你遇到的System.ArgumentException（初始化字符串格式不符合规范），本质是通过名称从配置中读取的连接字符串无效——要么没读到正确值，要么格式本身错误，但直接硬编码连接字符串能正常运行，说明问题出在配置读取环节或上下文/DI的配置逻辑上，以下是具体排查步骤：

1. 检查appsettings.json的连接字符串配置 #

• 确认连接字符串的键名和上下文/DI中引用的名称完全一致（C#是大小写敏感的，比如MyConn和myconn会被视为不同键）
• 验证连接字符串本身格式，以SQL Server为例，正确格式示例：

  "ConnectionStrings": {
    "MyDbConn": "Server=(localdb)\\mssqllocaldb;Database=YourDBName;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
  

  注意：反斜杠需要转义（\\），不要在值前后加多余引号或空格
• 检查appsettings.json是否被设置为复制到输出目录（右键文件→属性→复制到输出目录：如果较新则复制）

2. 检查DbContext的配置逻辑 #

重新执行Scaffold-DbContext命令后，生成的上下文类可能会被重置覆盖，需要确认：

• 上下文的OnConfiguring方法是否正确从配置读取连接字符串，而不是硬编码或引用错误名称：

  public class YourDbContext : DbContext
  {
      private readonly IConfiguration _config;
  
      public YourDbContext(IConfiguration config)
      {
          _config = config;
      }
  
      protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
      {
          if (!optionsBuilder.IsConfigured)
          {
              // 确保这里的名称和appsettings.json的键名一致
              optionsBuilder.UseSqlServer(_config.GetConnectionString("MyDbConn"));
          }
      }
  }
  

• 避免同时在OnConfiguring和DI注册中重复配置，两者保持统一即可

3. 验证Program.cs中的DI注册 #

确认依赖注入环节是否正确关联配置中的连接字符串：

// Program.cs
builder.Services.AddDbContext<YourDbContext>(options =>
    // 同样确保名称匹配
    options.UseSqlServer(builder.Configuration.GetConnectionString("MyDbConn")));

4. 调试验证配置读取结果 #

在Program.cs中添加调试代码，确认配置是否正确读取：

var connString = builder.Configuration.GetConnectionString("MyDbConn");
Console.WriteLine($"读取到的连接字符串：{connString}");

如果输出为空或格式错误，说明配置文件未被正确加载；如果输出正确，则问题出在上下文的配置逻辑上。

5. 修正Scaffold命令参数 #

后续更新实体时，建议直接引用配置中的连接字符串名称，避免生成硬编码的上下文：

Scaffold-DbContext "Name=MyDbConn" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -Force

使用Name=连接字符串名称的格式，让Scaffold命令直接读取配置，生成的上下文会自动保留正确的配置引用逻辑。

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