EF Core 6.0.8中Update-database忽略迁移历史重复建表求助

可能成因 #

• __efmigrationshistory表的迁移记录与本地代码的迁移文件不匹配：EF Core通过迁移ID和哈希值验证迁移是否已执行，若数据库中记录的ID、哈希与本地迁移文件不一致，会被判定为未执行。
• 连接字符串配置错误：新主机上的连接字符串指向空白数据库，而非你同步的目标库，EF认为无迁移历史，从头创建所有表。
• 命名约定被修改：新环境下EF的表命名配置变更（比如从蛇形命名切换为默认帕斯卡命名），导致EF识别不到现有表，重复创建。

排查与解决步骤 #

1. 验证连接字符串与目标库 #

• 检查项目配置文件（appsettings.json/appsettings.{环境}.json）中的连接字符串，确认指向同步后的正确数据库实例。
• 用数据库管理工具连接目标库，确认__efmigrationshistory表和原有业务表存在。

2. 核对迁移记录与本地文件 #

• 导出目标库__efmigrationshistory表的MigrationId和ProductVersion字段。
• 对比本地Migrations文件夹下的迁移文件名（文件名开头的GUID+名称即为MigrationId），确保数据库中所有记录都能在本地找到，且顺序一致。
• 若存在数据库有记录但本地无对应文件的情况，从原项目同步缺失的迁移文件；若本地有文件但数据库无记录，先确认是否为同步遗漏，不要手动插入记录。

3. 修复迁移哈希值不匹配 #

EF Core会验证迁移文件的哈希值与__efmigrationshistory中的记录是否一致，不一致会判定为未执行：

• 执行命令查看迁移状态：

  dotnet ef migrations list
  

  该命令会标记本地迁移中哪些已应用到数据库。
• 若数据库中已存在的迁移被标记为未应用，说明哈希不匹配，可重新生成哈希并同步（仅在确认迁移逻辑未修改时使用）：

  dotnet ef migrations add {迁移名称} -force
  

  执行完成后再运行Update-Database同步到数据库。

4. 检查命名约定配置 #

• 查看DbContext的OnModelCreating方法，确认表命名约定未被修改，比如：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      // 确保原本的命名配置未被注释或删除
      modelBuilder.UseSnakeCaseNamingConvention();
  }
  

  若配置被移除，EF会默认使用帕斯卡命名，导致识别不到原有表。

5. 极端情况：重新对齐迁移历史（谨慎操作，先备份数据） #

1. 备份目标库的所有业务数据。
2. 删除目标库中所有EF创建的业务表，保留__efmigrationshistory表。
3. 执行Update-Database，EF会根据迁移历史跳过已执行的迁移，仅执行未完成的字段添加操作。
4. 恢复备份的业务数据。

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