Entity Framework Code First迁移忽略[Key]强制生成复合主键问题

云原生阿岚

2026-9-23

EF Core 强制生成复合主键问题解决方案

根本原因

EF Core 会默认将包含两个指向同一实体外键的实体识别为多对多关系的联接实体，因此会自动将两个外键设为复合主键，覆盖你配置的[Key]特性。
手动修改迁移文件不生效是因为 EF Core 迁移快照文件（Migrations 目录下后缀为 Snapshot 的文件）中仍存储了复合主键的配置，单次迁移文件的修改不会同步更新快照，后续迁移或数据库更新操作仍会按照快照配置执行。

解决方法

方法1：使用 DataAnnotations 提升主键配置优先级

在 Challenge 实体的 Id 属性上补充Column和DatabaseGenerated特性，明确主键排序和值生成规则：

public class Challenge
{
    [Key] 
    [Column(Order = 0)]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public Guid Id { get; set; }

    // 其余属性保持原有配置不变
    public Guid ChallengerId { get; set; }
    public Guid ChallengeeId { get; set; }

    [ForeignKey("ChallengerId")]
    public virtual Player Challenger { get; set; }

    [ForeignKey("ChallengeeId")]
    public virtual Player Challengee { get; set; }

    public DateTime Initiated { get; set; }
}

方法2：在 DbContext 中显式配置主键（优先级最高，最稳妥）

在你的 DbContext 类的OnModelCreating方法中显式指定 Challenge 实体的主键：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 显式指定Challenge的主键为Id
    modelBuilder.Entity<Challenge>()
        .HasKey(c => c.Id);
    
    // 保留你原有其他配置
    base.OnModelCreating(modelBuilder);
}