Entity Framework无法识别模型变更已应用至数据库的求助

问题场景与现象 #

• 将开发分支合并至本地分支；
• 合并后新增了一个添加列的迁移，且该迁移被插入到本地原有迁移之前；
• 执行update-database后，迁移已成功应用：_MigrationHistory表中能看到该迁移，数据库中已生成对应列，模型变更在业务逻辑中正常生效；
• 但EF始终不认为该模型变更已完成，执行add-migration时会重复生成完全相同的迁移内容；
• 再次执行update-database时持续报错：

Unable to update database to match the current model because there are pending changes and automatic migration is disabled. Either write the pending model changes to a code-based migration or enable automatic migration

疑问与尝试 #

• 如何让EF确认模型变更已经应用到数据库？不清楚add-migration识别待迁移变更的具体机制；
• 本地没有可用的模型快照文件；
• 尝试使用全新空数据库，先应用开发分支所有迁移，再应用本地分支的迁移，问题依然存在。

补充说明 #

• 合并开发分支前已删除本地的迁移文件，但即使在全新数据库场景下（无本地迁移文件），问题依旧；
• 开发分支本身无此异常：执行update-database后，EF能正常识别迁移已应用，不会重复生成迁移；但合并到本地分支后，EF就无法识别新迁移的变更状态。

环境配置 #

<TargetFramework>net6.0</TargetFramework>
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="6.0.7" />
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="6.0.7" />
<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="6.0.7">

解决方案 #

1. 生成匹配当前数据库的模型快照 #

由于缺少可用的模型快照，EF无法将当前模型与数据库状态做对比，可通过以下命令生成空迁移并创建快照：

Add-Migration InitialSnapshot -IgnoreChanges

这个命令会生成一个无操作的迁移文件，同时创建对应的模型快照，让EF将当前模型标记为与数据库状态一致。

2. 重置迁移状态（若快照生成后仍有问题） #

• 删除本地所有迁移文件；
• 执行命令生成初始空迁移：

Add-Migration Initial -IgnoreChanges

• 执行update-database将这个空迁移应用到数据库，此时_MigrationHistory会记录该迁移，EF会认为当前模型就是数据库的基准状态。

3. 排查分支合并后的模型冲突 #

仔细对比开发分支与本地分支的以下内容，确保没有隐藏的不一致：

• 实体类的属性定义、数据注解（如[Column]、[Required]等）；
• DbContext中的OnModelCreating配置；
• 实体类的导航属性、关系配置。
  哪怕是注释、属性顺序的细微差异，都可能被EF判定为模型变更。

4. 清理EF缓存 #

• 删除项目的bin和obj目录；
• 重新生成解决方案；
• 再次尝试add-migration或update-database命令，避免EF使用旧的模型缓存。

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