EF Core Code First 配置复合主键外键添加迁移报错如何解决

错误原因 #

Team实体配置了Team_Id + Club_Id复合主键，所有关联Team的外键必须同时包含这两个字段才能匹配主键约束，你当前Team_Players中仅为Team导航属性绑定了Team_Id单个外键字段，因此触发匹配失败报错。另外你提供的代码中还存在一处导航属性类型笔误，也会导致迁移失败。

调整步骤 #

1. 修正Player类的笔误
   你当前Player类中关联俱乐部的导航属性类型错误写为Team，修改为正确的Club类型：

public class Player : BaseModel
{
    [Required]
    [Display(Name = "ID")]
    public string UserId { get; set; }
 
    // 修正导航属性类型为Club
    [ForeignKey("Club_Id")]
    public Club Club { get; set; }

    [Required]
    [Display(Name = "Club ID")]
    [MaxLength(50, ErrorMessage = "Field cannot be more than 50 Characters")]
    public string Club_Id { get; set; }
}

2. 配置Team_Players关联Team的复合外键
   推荐使用Fluent API配置，避免特性配置的顺序匹配问题，在OnModelCreating方法中追加如下配置：

modelBuilder.Entity<Team_Players>()
    .HasOne(tp => tp.Team)
    // 若Team实体中存在关联Team_Players的集合导航属性，可在括号内填写属性名，例如WithMany(t => t.TeamPlayers)
    .WithMany()
    .HasForeignKey(tp => new { tp.Team_Id, tp.Club_Id });

如果你倾向用特性配置，可以直接修改Team_Players中Team导航属性的ForeignKey标记，指定两个外键字段，注意字段顺序要和Team的复合主键顺序完全一致：

// 修正为复合外键配置
[ForeignKey(nameof(Team_Id) + "," + nameof(Club_Id))]
public Team Team { get; set; }

3. 可选优化建议
   统一字段命名规范，比如将Club_id改为ClubId，避免大小写拼写不一致导致的潜在绑定问题。

修改完成后重新执行Add-Migration和Update-Database命令即可正常完成迁移。

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