如何在Azure App Service中使用Code First迁移及配置多环境连接字符串

我来一步步帮你搞定这几个核心问题：

一、EF迁移是否会自动执行？ #

默认情况下，发布到Azure App Service后，Add-Migration和Update-Database不会自动运行——这俩是本地开发时的命令，发布包本身不包含迁移的创建逻辑（除非你手动配置触发）。不过有两种可行方式让迁移在发布后生效：

1. 代码中自动执行迁移（适合测试环境，生产环境谨慎使用） #

在Program.cs里添加自动迁移逻辑，应用启动时会自动应用所有未执行的迁移：

var app = builder.Build();

// 添加迁移执行逻辑，要放在Build之后、中间件配置之前
using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    dbContext.Database.Migrate(); // 自动应用未完成的迁移
}

// 后续中间件配置...
app.UseHttpsRedirection();
// ...

⚠️ 注意：生产环境用这个要格外小心——如果迁移涉及表结构变更（比如删字段、改主键），自动执行可能导致服务中断或数据丢失。生产环境更推荐手动执行：可以通过Azure App Service的高级工具(Kudu) 打开控制台，进入站点根目录的wwwroot，执行dotnet ef database update（前提是项目包含EF工具），或者用CI/CD工具在部署前单独执行迁移命令。

2. 发布时配置迁移命令 #

在Visual Studio的发布向导中，进入“设置”页面，找到执行EF迁移选项（ASP.NET Core项目会默认提供），勾选后发布过程中会自动执行Update-Database。

二、如何切换到Azure的连接字符串？ #

ASP.NET Core的配置系统有优先级规则：Azure App Service应用设置里的连接字符串会覆盖本地appsettings.json的配置，这是最安全且推荐的方式（避免把生产环境的敏感连接字符串硬编码到代码里）。具体操作：

1. 本地开发：在appsettings.Development.json中配置本地数据库的连接字符串，开发时应用会自动加载这个文件的配置。
2. Azure部署：
   • 登录Azure门户，找到目标App Service，进入配置→应用设置
   • 在“连接字符串”区域，添加和你的DbContext命名一致的连接字符串（比如DbContext用的是DefaultConnection，就添加同名项，值填Azure SQL的连接字符串）
   • 保存后，应用重启会自动使用Azure配置的连接字符串，忽略本地文件中的配置。

如果你想用环境特定的配置文件（比如appsettings.Staging.json、appsettings.Production.json），可以在Azure App Service的应用设置里添加ASPNETCORE_ENVIRONMENT变量，值设为Staging或Production，应用会自动加载对应环境的配置文件。

三、配置三个带不同连接字符串的发布配置文件 #

在Visual Studio里可以快速创建多套发布配置，对应本地、Azure测试、Azure生产三个环境：

1. 创建发布配置文件：

   • 右键项目→选择“发布”
   • 按向导创建第一个配置文件，命名为Local（发布到本地文件夹，用于本地验证）
   • 回到发布页面，点击“创建新配置文件”，分别创建AzureStaging（对应Azure测试环境的App Service）和AzureProduction（对应Azure生产环境的App Service）

2. 为每个配置设置环境变量：

   • 打开任意发布配置的“设置”页
   • 在“环境变量”区域添加ASPNETCORE_ENVIRONMENT变量，对应值：
     • Local配置：Development
     • AzureStaging配置：Staging
     • AzureProduction配置：Production
   • 保存配置

3. 配置对应环境的连接字符串：

   • 在项目中添加appsettings.Staging.json和appsettings.Production.json，分别填入测试、生产环境的连接字符串（如果不想把敏感信息存代码里，可跳过这步，直接在Azure App Service的应用设置中配置）
   • 本地的appsettings.Development.json保持本地数据库的连接字符串即可

这样，你选择不同的发布配置文件时，应用会自动加载对应环境的配置，连接字符串也会随之切换。

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