如何在EF Core中使用Fluent API配置多对多关系？

一、问题分析 #

你当前的实体结构和配置是一对多关系（一个ActivityGroup对应多个People），但需求是多对多（一个People属于多个ActivityGroup，一个ActivityGroup包含多个People），所以需要调整实体定义和Fluent API配置。

二、实体类修改 #

1. 修改PeopleBase基类 #

移除基类中的ActivityGroupId字段，多对多关系不需要在主实体中存储对方的外键，EF Core会自动生成中间关联表：

public abstract class PeopleBase : ModelBase
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public Guid PeopleId { get; set; }

    public Guid? UserId { get; set; }

    // 移除这一行：public Guid? ActivityGroupId { get; set; }

    public string Code { get; set; }
    public string Name { get; set; }
    public string Surname { get; set; }
    public PeopleActiveType Active { get; set; }
}

2. 修改People实体 #

将单个ActivityGroup导航属性改为集合类型，并在构造函数中初始化：

public class People : PeopleBase
{
    public People()
    {
        RegistrationList = new HashSet<Registration>();
        // 新增初始化多对多集合
        ActivityGroups = new HashSet<ActivityGroup>();
    }

    public virtual ICollection<Registration> RegistrationList { get; set; }
    public virtual User User { get; set; }

    // 替换单个导航属性为集合
    public virtual ICollection<ActivityGroup> ActivityGroups { get; set; }
}

3. ActivityGroup实体保持不变 #

你的ActivityGroup已经正确定义了多对多的集合导航属性：

public class ActivityGroup : ActivityGroupBase
{
    public ActivityGroup()
    {
        PeopleList = new HashSet<People>();
        ActivityList = new HashSet<Activity>();
    }

    public ICollection<People> PeopleList { get; set; }
    public ICollection<Activity> ActivityList { get; set; }
}

三、Fluent API 多对多配置 #

在DbContext的OnModelCreating方法中，使用HasMany.WithMany配置多对多关系：

基础配置（自动生成中间表） #

EF Core 6会自动创建中间表，默认表名为PeopleActivityGroup，列名为PeopleId和ActivityGroupId，也可以自定义表名：

modelBuilder.Entity<People>()
    .HasMany(p => p.ActivityGroups) // 一个People对应多个ActivityGroup
    .WithMany(ag => ag.PeopleList)   // 一个ActivityGroup对应多个People
    .UsingEntity(j => j.ToTable("PeopleActivityGroups")); // 可选：自定义中间表名称

自定义中间表列名（可选） #

如果需要自定义中间表的列名和主键，可以进一步配置：

modelBuilder.Entity<People>()
    .HasMany(p => p.ActivityGroups)
    .WithMany(ag => ag.PeopleList)
    .UsingEntity<Dictionary<string, object>>(
        "PeopleActivityGroups", // 中间表名称
        j => j.HasOne<ActivityGroup>().WithMany().HasForeignKey("ActivityGroupId"), // 中间表指向ActivityGroup的外键
        j => j.HasOne<People>().WithMany().HasForeignKey("PeopleId"), // 中间表指向People的外键
        j =>
        {
            j.HasKey("PeopleId", "ActivityGroupId"); // 复合主键
            j.ToTable("PeopleActivityGroups");
        });

四、常见问题说明 #

• 你之前尝试的HasForeignKey是一对多关系的配置方式，多对多关系不需要在主实体中指定外键，外键会被放在EF自动生成的中间表中。
• 如果需要对中间表添加额外字段（比如关联创建时间），则需要显式定义中间表实体，再分别配置两个一对多关系。

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