ASP.NET-Core 3.1 迁移自动发布功能不生效问题咨询

问题成因 #

• 权限问题是域内intranet环境下该问题的最高发原因：Visual Studio发布时勾选「发布时应用此迁移」选项后，生成的迁移脚本默认仅上传到站点目录，不会自动执行的核心原因是发布流程的执行身份、IIS应用程序池运行身份均没有目标SQL Server的DDL操作权限（建表、改表结构等权限），仅具备常规业务数据读写权限，自动执行步骤会静默失败无明显报错。
• context.Database.Migrate()失效的版本适配问题：ASP.NET Core 3.x对主机启动流程做了重构，2.x时代直接写在Program.cs的Migrate逻辑没有适配3.x的IHost启动生命周期，会在服务未完全构建完成时提前执行，或是因数据库连接串读取失败、权限不足等问题抛出未捕获异常后被启动逻辑吞掉，最终表现为迁移不生效。
• 迁移快照的版本兼容问题：2.x版本生成的迁移快照与3.x版本EF Core的快照格式存在不兼容场景，会导致发布流程错误判断迁移已全部应用，自动跳过执行步骤，即便实际未运行过新迁移。
• File System发布模式的原生限制：文件系统发布本身仅负责文件同步到目标服务器，默认不包含远程执行SQL脚本的环节，勾选迁移应用选项后仅完成生成脚本、上传脚本两步操作，只有Azure发布等云原生发布流程才内置了自动执行迁移的远程调用能力。

可行解决办法 #

• 方案1：集成迁移脚本到CI/CD自动执行（生产环境推荐）
  本地使用dotnet ef migrations script --output migrate.sql --idempotent命令生成可多次运行不报错的幂等迁移脚本，在域内的发布流水线中添加SQL脚本执行步骤，使用具备数据库DDL权限的专用服务账户执行脚本，全程无需手动操作。
• 方案2：适配3.x版本的启动时迁移逻辑（仅测试/低风险环境使用）
  若仍需要启动时自动迁移，不要直接在Program.cs主方法调用Migrate，需在IHost构建完成后通过服务作用域获取上下文执行，示例代码：

  var host = CreateHostBuilder(args).Build();
  using (var scope = host.Services.CreateScope())
  {
      var dbContext = scope.ServiceProvider.GetRequiredService<你的DbContext类名>();
      dbContext.Database.Migrate();
  }
  host.Run();
  

  注意需提前给IIS应用程序池的运行身份开放数据库的DDL操作权限，该方案不符合微软生产环境最佳实践，不推荐在正式环境使用。
• 方案3：管理员触发式迁移执行
  在站点中添加一个仅管理员有权限访问的接口，发布完成后手动调用接口触发迁移执行，迁移逻辑参考方案2的作用域写法，执行过程中记录详细日志便于排查问题。
• 方案4：服务器计划任务自动执行
  发布后迁移脚本已上传到inetpub目录的前提下，可在服务器上配置定期运行的计划任务，检测目录下新增的迁移脚本，使用具备权限的账户自动执行，执行完成后移动到归档目录避免重复执行。

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