EF执行数据库迁移无法切换至Production环境的解决方法

两个问题都是配置加载逻辑不符合预期导致的：

• 执行dotnet run --environment Production仍识别为Development，绝大多数情况是构建主机时未传入命令行参数，或是本地系统预设了ASPNETCORE_ENVIRONMENT=Development环境变量，优先级覆盖了命令行传入的值。
• 修改appsettings.json不生效，是因为.NET的配置系统会优先加载环境特定的配置文件，生产环境默认读取appsettings.Production.json的内容覆盖基础配置，改通用的appsettings.json自然不会生效。

1. 先确保环境参数能被正确识别 #

先检查项目的Program.cs配置：

• .NET 6+ 顶级语句版本，确认构建WebApplication时传入了args，且命令行配置源已加载：

// 必须把args传进CreateBuilder，否则命令行参数不会被读取
var builder = WebApplication.CreateBuilder(args);

// 如果你自定义了配置加载顺序，确保AddCommandLine放在最后（配置规则是后加载的优先级更高）
builder.Configuration
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true)
    .AddEnvironmentVariables()
    .AddCommandLine(args);

• .NET 5及更早使用Startup的版本，确认CreateHostBuilder传入了args：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    // 这里漏传args的话，所有命令行参数都会失效
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

改完后可以临时加一行日志验证环境是否正确加载：

var app = builder.Build();
// 启动时打印当前环境，确认输出Production再往下走
app.Logger.LogInformation("当前运行环境：{0}", app.Environment.EnvironmentName);

如果执行dotnet run --environment Production还是输出Development，先清掉当前终端里的预设环境变量再试：

# Windows cmd
set ASPNETCORE_ENVIRONMENT=
# PowerShell
Remove-Item Env:ASPNETCORE_ENVIRONMENT -ErrorAction SilentlyContinue
# Linux/macOS
unset ASPNETCORE_ENVIRONMENT

2. 正确配置生产数据库连接 #

不要修改根目录的appsettings.json，新建（如果不存在）appsettings.Production.json文件，写入生产库的连接配置：

{
  "ConnectionStrings": {
    "DefaultConnection": "你的托管生产库连接串，注意补全SSL、端口、账号密码等必填参数"
  }
}

生产环境部署时更推荐直接用环境变量配置连接串，优先级比配置文件更高，也能避免敏感信息被提交到代码仓库。

3. 执行生产环境EF迁移 #

EF Core工具默认读取Development环境配置，迁移时必须显式指定生产环境，否则会误连本地库：

# 生产环境建议先生成SQL脚本人工审核，避免误操作
dotnet ef migrations script --environment Production -o ./prod_migration.sql

# 确认脚本没问题后，执行生产环境迁移
dotnet ef database update --environment Production

如果是发布后在生产服务器执行迁移，也可以先在当前终端设置环境变量再执行命令，不用每次带参数：

# Windows cmd
set ASPNETCORE_ENVIRONMENT=Production
# PowerShell
$env:ASPNETCORE_ENVIRONMENT = "Production"
# Linux/macOS
export ASPNETCORE_ENVIRONMENT=Production

# 之后直接执行迁移即可
dotnet ef database update

• 不要把生产库连接串写在公共的appsettings.json里，很容易出现本地开发误连生产库删数据的事故。
• 如果用IIS部署，需要在站点的「配置编辑器-环境变量」里单独加ASPNETCORE_ENVIRONMENT=Production，否则IIS托管时默认会用Development环境。
• 执行dotnet ef命令时工作目录要切到包含DbContext的项目根目录，不要在解决方案根目录直接跑，否则会加载不到正确的配置。

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