EF Core中如何为多对多关系添加关联属性？

问题背景 #

当前使用EF Core代码优先建模，需要为System和Component的多对多关系添加Version关联属性，要求自动生成的中间表包含Version列。原代码通过HasMany.WithMany()自动生成中间表，但手动修改的实体结构未实现预期效果。

解决方案 #

EF Core中，带关联属性的多对多关系无法使用自动生成的中间表，必须显式定义连接实体类，并配置一对多关系来替代自动多对多。具体步骤如下：

1. 定义显式连接实体类

创建包含两个实体外键、关联属性及导航属性的连接实体，可选择复合主键或单独主键：

// 连接实体类，包含关联属性Version
public class SystemComponent
{
    // 方式1：使用复合主键（推荐，符合多对多关联的唯一性约束）
    public string SystemId { get; set; }
    public int ComponentId { get; set; }
    
    // 关联属性
    public string Version { get; set; }

    // 导航属性
    public System System { get; set; }
    public Component Component { get; set; }

    // 方式2：使用单独主键（可选，需额外配置）
    // public int Id { get; set; }
}

2. 修改原实体类

将System和Component中的直接多对多导航属性，改为指向连接实体的集合：

public class System
{
    public string SystemId { get; set; }
    // 替换原List<Component>为连接实体集合
    public List<SystemComponent> SystemComponents { get; set; } = new List<SystemComponent>();
}

public class Component
{
    public int ComponentId { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    // 添加指向连接实体的集合
    public List<SystemComponent> SystemComponents { get; set; } = new List<SystemComponent>();
}

3. 配置实体关系（Fluent API）

在OnModelCreating中配置连接实体的主键及一对多关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置连接实体的复合主键（若使用方式1）
    modelBuilder.Entity<SystemComponent>()
        .HasKey(sc => new { sc.SystemId, sc.ComponentId });

    // 配置System与SystemComponent的一对多关系
    modelBuilder.Entity<SystemComponent>()
        .HasOne(sc => sc.System)
        .WithMany(s => s.SystemComponents)
        .HasForeignKey(sc => sc.SystemId);

    // 配置Component与SystemComponent的一对多关系
    modelBuilder.Entity<SystemComponent>()
        .HasOne(sc => sc.Component)
        .WithMany(c => c.SystemComponents)
        .HasForeignKey(sc => sc.ComponentId);
}

原尝试失败原因 #

之前定义的ComponentRelationship缺少System的外键和导航属性，EF Core无法识别其为多对多的连接实体，也未正确配置关系，导致生成的表不符合预期。

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