EF Core 7中如何映射多对多关联表的Page字段？

核心结论 #

直接在Document实体中添加Page属性来映射关联表的Page字段是不可行的，逻辑上也不合理。

原因分析 #

Page字段是Bill和Document之间关联关系的属性，而非Document自身的属性。同一个Document可能被多个Bill引用，每个关联对应的页码可能完全不同——比如文档A在账单1里对应第2页，在账单2里对应第5页，Document实体的单个Page属性根本无法存储多个不同的值，这违背了数据模型的基本逻辑。

正确解决方案：显式创建中间关联实体 #

EF Core要求，当多对多关联表包含额外字段时，必须通过显式中间实体来承载这些字段，这是框架的标准处理方式。以下是完整实现步骤：

1. 定义实体类 #

// 账单实体
public class Bill
{
    public long Id { get; set; }
    public string? Reference { get; set; }

    // 关联中间实体集合
    public HashSet<DocumentsOfBill> DocumentsOfBills { get; set; } = new();
}

// 文档实体
public class Document
{
    public long Id { get; set; }
    public string? Name { get; set; }

    // 关联中间实体集合
    public HashSet<DocumentsOfBill> DocumentsOfBills { get; set; } = new();
}

// 中间关联实体，承载额外字段Page
public class DocumentsOfBill
{
    public long IdBill { get; set; }
    public long IdDocument { get; set; }
    public int Page { get; set; }

    // 导航属性
    public Bill Bill { get; set; } = null!;
    public Document Document { get; set; } = null!;
}

2. Fluent API配置 #

internal class BillConfiguration : IEntityTypeConfiguration<Bill>
{
    public void Configure(EntityTypeBuilder<Bill> builder)
    {
        builder.ToTable("Bills");

        builder.HasKey(o => o.Id);
        builder.Property<long>(o => o.Id)
            .HasColumnName("Id")
            .HasColumnType("bigint")
            .IsRequired();

        builder.Property<string?>(o => o.Reference)
            .HasColumnName("Reference")
            .HasColumnType("varchar(50)");

        // 配置Bill与中间实体的一对多关系
        builder.HasMany(b => b.DocumentsOfBills)
               .WithOne(dob => dob.Bill)
               .HasForeignKey(dob => dob.IdBill);
    }
}

internal class DocumentConfiguration : IEntityTypeConfiguration<Document>
{
    public void Configure(EntityTypeBuilder<Document> builder)
    {
        builder.ToTable("Documents");

        builder.HasKey(o => o.Id);
        builder.Property<long>(o => o.Id)
            .HasColumnName("Id")
            .HasColumnType("bigint")
            .IsRequired();

        builder.Property<string?>(o => o.Name)
            .HasColumnName("Name");

        // 配置Document与中间实体的一对多关系
        builder.HasMany(d => d.DocumentsOfBills)
               .WithOne(dob => dob.Document)
               .HasForeignKey(dob => dob.IdDocument);
    }
}

internal class DocumentsOfBillConfiguration : IEntityTypeConfiguration<DocumentsOfBill>
{
    public void Configure(EntityTypeBuilder<DocumentsOfBill> builder)
    {
        builder.ToTable("DocumentsOfBills");

        // 配置复合主键
        builder.HasKey(dob => new { dob.IdBill, dob.IdDocument });

        // 配置Page字段
        builder.Property<int>(dob => dob.Page)
            .HasColumnName("Page")
            .IsRequired();
    }
}

3. 使用方式 #

查询时可以通过中间实体获取关联的文档和对应页码：

var billWithDocuments = await dbContext.Bills
    .Include(b => b.DocumentsOfBills)
        .ThenInclude(dob => dob.Document)
    .FirstOrDefaultAsync(b => b.Id == billId);

// 遍历获取每个文档的页码
foreach (var dob in billWithDocuments.DocumentsOfBills)
{
    Console.WriteLine($"文档：{dob.Document.Name}，页码：{dob.Page}");
}

关于“避免创建单独关联实体”的说明 #

EF Core的无中间实体多对多关系仅支持纯关联（关联表只有两个外键，无额外字段）。只要关联表存在额外字段，就必须通过显式中间实体来映射，这是框架的设计限制，没有绕过的方法——强行将关联属性放到某一端实体中，会导致数据逻辑混乱，无法正确存储和查询数据。

内容的提问来源于stack exchange，提问作者Álvaro García