EF Core执行Add-Migration报错：Employee实体的EmployeeRole属性已存在

核心原因 #

EF Core创建新迁移的逻辑是比对当前实体模型与Migrations目录下的上下文模型快照（xxxContextModelSnapshot.cs） 存储的上一次迁移完成后的模型状态，生成对应差量变更。该报错是快照文件中已存在EmployeeRole导航属性的配置，但EF的比对逻辑判定当前模型需要新增该属性，尝试重复写入时触发冲突。
你观察到的EmployeeRoleId灰显为正常现象：EF Core默认遵循主键约定，会自动将类名+Id格式的属性识别为主键，IDE提示该属性已被约定隐式配置，无需额外手动设置，不影响功能使用。

解决步骤 #

• 第一步，确认当前数据库与迁移记录完全同步，在包管理控制台执行命令：

Update-Database

待输出提示数据库已是最新状态后进行后续操作。

• 第二步，清理无效文件：如果本次执行Add-Migration Northwind1.3已生成部分临时迁移文件，直接手动删除对应文件。
• 第三步，修复模型快照冲突：
  打开Migrations/NorthwindContextModelSnapshot.cs文件，定位到Employee实体的配置段（报错栈已提示位置在第1086行附近），删除重复的EmployeeRole导航属性配置代码，仅保留一处有效配置即可。
• 第四步，重新创建迁移：

Add-Migration Northwind1.3

备用重置方案（适用于所有迁移已应用到数据库、无需保留历史迁移记录的场景） #

• 备份数据库后，删除Migrations目录下所有文件
• 执行命令初始化基线：

Add-Migration InitialBaseline

• 打开新生成的迁移文件，注释Up方法内所有建表、加字段的逻辑，仅保留空的Up和Down方法
• 执行Update-Database完成基线更新，后续新增迁移不会再出现重复属性冲突问题。

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