EF Core Code First迁移生成的数据库表存在模型外多余列如何解决

问题根因 #

EF Core的迁移体系不会直接连接数据库，拿代码模型和实际表结构做校验。它的比对逻辑很简单：项目Migrations目录下维护的ModelSnapshot.cs是固定基准，代表上一次迁移跑完之后，模型应该达到的状态。生成新迁移时，只会对比「当前代码定义的实体模型」和「这个快照文件」的差异，哪里不一样就生成对应的Up/Down操作。
你遇到的空迁移场景本质是基准错位：

• 这个多余列对应的字段，很早之前就从实体代码里删掉了，但后续所有的迁移生成流程中，这份旧的字段定义一直残留在快照文件里没被清掉
• 当你临时把这个字段补回实体模型时，当前模型的配置和快照里残留的配置完全一致，自然比对不出差异，生成的迁移就是空的
• 当你尝试把字段从模型移除（本质是想触发EF识别到列删除操作），因为快照和代码的对应关系早就跨了好几个版本错位，EF没法正确识别到这个很久以前就该完成的删除操作，生成的迁移依然是空的

分步操作方案 #

• 定位残留定义：打开ModelSnapshot.cs文件，全局搜索该多余列的列名，找到对应实体配置块下的整段字段定义，连带该字段关联的索引、默认值、约束等配置一并删除
• 同步修正历史迁移文件：在Migrations目录下全局搜索该列名，定位所有历史.cs迁移文件中涉及该列的创建、修改、删除的代码段，只删除和该列直接相关的Up/Down方法逻辑，不要改动其他实体、其他列的配置
• 对齐基准验证：完成上述修改后执行Add-Migration TempBaselineCheck生成临时迁移，正常情况下这份临时迁移的Up和Down方法内容为空——说明此时的快照已经和当前代码模型完全对齐，没有未识别的模型差异。验证完成后直接删除这份临时迁移的文件即可
• 处理数据库冗余列：等快照逻辑完全对齐后，直接在目标数据库中手动删除该多余列不会引发后续同步问题——因为后续所有快照、历史迁移记录中已经完全移除了对该列的定义，EF不会再把它当成需要校验的目标列

注意事项 #

• 清理残留定义时，不要直接删除整个历史迁移文件，只删掉和这个冗余列直接相关的代码段，不然会破坏历史迁移的可重放逻辑
• 如果这个列之前配过非空约束、外键关联、索引，要把这些关联的残留配置也一并清掉，不然下次生成迁移时会触发快照不匹配的报错

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