Update-Database报错：初始化字符串格式不符合规范（索引0开始）

核心原因 #

Update-Database命令的-Connection参数要求传入完整的数据库连接字符串内容，而你当前传入的是配置文件中连接串的名称（如ProductionConnection），并非实际的连接字符串，因此触发了格式错误异常。

解决方法 #

方法1：直接传入完整连接串 #

执行命令时，将实际的连接字符串作为-Connection参数的值：

# 更新生产环境数据库
Update-Database -Connection "Server=SRVPRODUCTION\\SQLEXPRESS;uid=userproduction;pwd=passwordproduction;Database=DBProduction;Encrypt=True;TrustServerCertificate=True;"

# 更新开发环境数据库
Update-Database -Connection "Server=WKSDEVELOPMENT\\SQLEXPRESS;uid=userdev;pwd=passworddev;Database=DBDevelopment;Encrypt=True;TrustServerCertificate=True;"

方法2：使用-ConnectionStringName参数（推荐） #

如果使用的是EF Core 5.0及以上版本，可以直接指定配置文件中的连接串名称，无需手动复制完整连接串：

# 更新生产环境数据库
Update-Database -ConnectionStringName ProductionConnection

# 更新开发环境数据库
Update-Database -ConnectionStringName DevelopmentConnection

该参数会自动从appsettings.json的ConnectionStrings节点中读取对应名称的连接串内容。

额外优化建议 #

检查你的Program.cs代码，开发环境分支的异常提示存在拼写错误：

// 原错误代码
throw new InvalidOperationException("Connection string 'DevelopConnection' not found.")

// 修正后代码
throw new InvalidOperationException("Connection string 'DevelopmentConnection' not found.")

虽然这不会影响迁移命令的执行，但会导致错误提示信息不准确，建议修正。

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