EF Core迁移未应用致ASP.NET Core启动失败，求解决及原因分析

• 迁移执行时机滞后于应用启动
  ASP.NET Core启动时，若依赖EF Core的服务（比如身份认证、业务逻辑组件）先完成初始化，而迁移代码在后续才执行，就会出现应用先访问数据库、但新列尚未创建的情况。正确的做法是将context.Database.Migrate()放在Program.cs的最早期执行——要早于服务注册、中间件配置的步骤。

• 发布流程未触发迁移命令
  若是部署到Azure App Service：

  • 检查发布配置是否勾选了执行EF Core迁移选项；
  • 若用CI/CD管道（比如Azure DevOps），确认部署阶段是否添加了dotnet ef database update命令，且执行该命令的账号拥有数据库的修改权限。

• 数据库账户权限不足
  应用程序池或部署脚本使用的数据库账号，若没有ALTER TABLE权限，或无法向__EFMigrationsHistory表插入数据，会导致迁移静默失败——既不会抛出明确的启动错误，也不会在数据库中记录迁移ID，最终应用启动时找不到新增列。

• 迁移文件未被正确发布
  检查部署包中是否包含EF Core的迁移类文件。如果项目文件里给迁移类设置了CopyToPublishDirectory="Never"，发布后应用找不到迁移定义，自然无法执行迁移。

• 环境配置不匹配
  发布环境的连接字符串若和开发环境不一致，会导致应用连接到错误的数据库——迁移执行到了其他库，而当前应用使用的目标库并未应用该迁移。可以核对appsettings.Production.json里的连接字符串是否指向正确的Azure数据库。

• 迁移依赖引发隐性异常
  若项目中有多个DbContext，或迁移代码依赖未初始化的服务，会导致Migrate()方法执行失败。比如调用Migrate()前，某些依赖服务未完成初始化，引发隐性异常中断迁移流程，表面上看就是迁移没执行。

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