.NET Core 8从SqlClient迁移至EF Core时，原可用连接字符串引发初始化格式错误

我之前做类似迁移时也碰到过一模一样的坑，咱们一步步拆解排查：

1. 先确认DbContext的注册配置是否正确 #

这是最容易踩的隐形坑——你有没有在Program.cs里正确注册DbContext并传入连接字符串？标准写法应该是这样的：

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

重点注意：GetConnectionString里的键名必须和appsettings.json中ConnectionStrings下的键完全匹配，哪怕大小写、空格差异都可能导致读错。你可以临时加一行代码输出读取到的字符串，确认是不是你预期的内容：

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

2. 清理连接字符串里的冗余冲突参数 #

你的连接字符串同时写了Trusted_Connection=True和Integrated Security=True——这两个参数是完全等价的，同时存在会让EF Core的SqlServer提供程序解析时出现冲突。保留其中一个即可，比如简化成：

"Server=.\\SQLEXPRESS;Database=my_database_name;Trusted_Connection=True;Encrypt=False;"

3. 修复appsettings.json里的字符串格式问题 #

你给出的连接字符串带有换行，JSON对多行字符串的处理非常严格，这种换行很可能导致解析出的字符串包含多余空白字符，进而触发格式错误。把连接字符串改成单行是最稳妥的做法：

"ConnectionStrings": {
  "MyDbConn": "Server=.\\SQLEXPRESS;Database=my_database_name;Trusted_Connection=True;Encrypt=False;"
}

4. 硬编码连接字符串做测试（排除配置读取问题） #

为了确认是不是配置读取环节出了问题，你可以临时在DbContext的OnConfiguring方法里直接写连接字符串，测试是否能正常查询：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    if (!optionsBuilder.IsConfigured)
    {
        // 用@符号避免转义，或者用双反斜杠
        optionsBuilder.UseSqlServer(@"Server=.\\SQLEXPRESS;Database=my_database_name;Trusted_Connection=True;Encrypt=False;");
    }
}

如果这样能正常运行，说明问题出在配置读取环节，而非字符串本身的格式。

5. 排查是否有其他配置覆盖了连接字符串 #

有时候环境变量、用户机密（User Secrets）里的同名连接字符串会覆盖appsettings里的内容。你可以右键项目→管理用户机密，检查里面有没有意外添加的配置，或者查看系统环境变量里是否存在相关设置。

按这些步骤排查下来，基本就能解决你遇到的初始化格式错误问题了。

备注：内容来源于stack exchange，提问作者perihelions