Entity Framework Code First迁移未使用指定外键反而生成新列

问题根因 #

EF Core 默认外键约定为「导航属性名称+关联实体主键名称」，你的Complaint实体中导航属性为ReceiverUserInfo，关联的User实体主键为Id，默认会自动生成ReceiverUserInfoId作为外键字段。你写的Fluent API配置未生效通常是以下原因导致：

1. 旧迁移未清理，新增迁移时继承了之前的错误结构
2. 配置未明确指定关联主体的主键，导致约定优先级高于手动配置

解决步骤 #

1. 清理错误迁移
   先删除项目中包含ReceiverUserInfoId字段的迁移文件，如果已经将错误结构同步到数据库，开发环境可直接删除数据库，生产环境建议先回滚到上一个正常迁移版本。
2. 修正外键配置
   两种方案二选一即可，推荐优先用数据注解更直观，避免和默认约定冲突：
   • 方案1：在Complaint实体的导航属性上加外键注解

   public class Complaint
   {
       [Key]
       public int? ComplaintID { get; set; }
       ...
       public string ReceivingOfficer { get; set; }
       ...
       [ForeignKey(nameof(ReceivingOfficer))]
       public virtual User ReceiverUserInfo { get; set; }
   }
   

   • 方案2：完善Fluent API配置，明确指定关联主键

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       base.OnModelCreating(modelBuilder);
   
       modelBuilder.HasAnnotation("Relational:Collation", "SQL_Latin1_General_CP1_CI_AS");
       
       modelBuilder.Entity<Complaint>()
           .HasOne(x => x.ReceiverUserInfo)
           .WithMany()
           .HasForeignKey(x => x.ReceivingOfficer)
           .HasPrincipalKey(x => x.Id)
           .OnDelete(DeleteBehavior.Cascade)
           .IsRequired();
   }
   

3. 重新生成迁移并更新
   清理项目后重新生成，执行Add-Migration（Package Manager Console）或dotnet ef migrations add命令新增迁移，检查生成的迁移代码中仅包含ReceivingOfficer作为外键，没有ReceiverUserInfoId字段后，执行更新数据库命令即可。

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