部署至Azure的ASP.NET MVC应用EF迁移报错求助

我之前在部署ASP.NET MVC到Azure时碰到过完全一样的问题，折腾了好一阵才解决，给你几个亲测有效的排查和解决方向：

• 核对__MigrationHistory系统表的一致性
  登录Azure的SQL数据库（用SSMS连接），找到__MigrationHistory表，对比本地数据库的同表记录：

  • 检查所有迁移的MigrationId是否完全一致，有没有Azure数据库里缺失或者多余的记录
  • 重点看ProductVersion字段，本地和Azure的EF版本必须完全匹配（比如都是6.0.25或者7.0.10），如果版本不一致，EF会认为模型有变更，哪怕迁移已经应用。如果发现版本不匹配，手动更新Azure数据库里的ProductVersion值和本地一致（操作前记得备份数据库）。

• 强制标记迁移为已应用
  在Visual Studio的Package Manager Console中，确保连接的是Azure远程数据库，执行以下命令：

  # 如果知道最后一次成功应用的迁移名称，强制同步到该版本
  Update-Database -TargetMigration:"<你的最后一次迁移名称>" -Force
  

  如果不确定迁移名称，或者所有迁移都已经在数据库中存在，可以生成一个空的初始化迁移来让EF认为模型与数据库一致：

  Add-Migration Initial -IgnoreChanges
  Update-Database
  

  这个命令会生成一个没有任何变更的迁移，执行后EF会将其标记为已应用，从而消除“待处理变更”的错误。

• 检查Azure应用服务的配置细节

  • 确认Azure App Service的连接字符串是否完全正确，有没有指向测试环境的数据库（部署时很容易犯这个错）。可以在Azure门户的应用服务“配置”->“连接字符串”里核对。
  • 检查应用配置文件（appsettings.json或web.config）中是否正确指定了MigrationsAssembly，如果你的迁移代码在单独的类库项目中，必须明确指定程序集名称，否则EF在Azure上找不到迁移记录：

    // appsettings.json示例
    "ConnectionStrings": {
      "YourDbContext": "Server=tcp:...;"
    },
    "EntityFrameworkCore": {
      "MigrationsAssembly": "Your.Migrations.Project.Name"
    }
    

• 清理本地迁移缓存并重建
  有时候本地的迁移快照文件会出现异常，导致生成重复的迁移：

  1. 先备份项目中Migrations文件夹的所有内容
  2. 删除Migrations文件夹下除了DbContextModelSnapshot.cs之外的所有迁移文件（如果没有Snapshot文件就全删）
  3. 在Package Manager Console中执行Add-Migration Initial -IgnoreChanges生成新的空迁移
  4. 连接远程数据库执行Update-Database，完成后再重新部署应用到Azure

• 确认EF版本的全局一致性
  本地开发环境的EF Core/EF6版本，必须和Azure部署的应用中使用的版本完全一致。可以通过以下方式检查：

  • 本地项目右键->“管理NuGet程序包”，查看EntityFramework相关包的版本
  • 登录Azure App Service的Kudu控制台（https://<你的应用名>.scm.azurewebsites.net/DebugConsole），进入site/wwwroot/bin目录，查看EF相关dll的版本号，确保和本地一致。如果不一致，重新发布时要确保所有NuGet包都同步更新。

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