EF Core用Fluent API配置无连接实体自引用多对多关系报错解决

问题根源分析 #

1. 实体属性访问性问题：Id和Name是私有字段，EF Core无法访问这些成员完成映射，即便手动配置主键，也会因无法识别实体属性触发异常。
2. 拼写错误：配置代码中的ContactPersosns是笔误，应为ContactPersons。
3. 未指定连接表名称：EF Core默认会生成连接表名，但你的数据库已有固定名称PersonsAndContacts，必须显式指定。
4. 自引用关系外键映射错误：未正确关联连接表外键与导航属性的对应关系。
5. 私有集合字段未配置：公开的IReadOnlyCollection对应的私有字段_contactPersons和_representedPersons，需告知EF Core使用这些字段进行数据操作。

正确配置步骤 #

1. 修正实体类

将Id和Name改为公开属性，确保EF Core能正常访问：

public class Person
{
    public long Id { get; set; }
    public string Name { get; set; }

    private ObservableCollection<Person> _contactPersons = new ObservableCollection<Person>();
    public IReadOnlyCollection<Person> ContactPersons => _contactPersons;

    private ObservableCollection<Person> _representedPersons = new ObservableCollection<Person>();
    public IReadOnlyCollection<Person> RepresentedPersons => _representedPersons;
}

2. 配置Fluent API关系

在OnModelCreating中完成如下配置：

modelBuilder.Entity<Person>(paramPersonConfiguracion =>
{
    // 配置主键映射
    paramPersonConfiguracion.HasKey(o => o.Id);
    paramPersonConfiguracion.Property(o => o.Id)
        .HasColumnName("IDPerson")
        .HasColumnType("bigint")
        .IsRequired();

    // 配置Name属性映射（根据实际数据库列名调整）
    paramPersonConfiguracion.Property(o => o.Name)
        .HasColumnName("Name")
        .IsRequired(false);

    // 配置自引用多对多关系
    var contactRelationship = paramPersonConfiguracion
        .HasMany(p => p.ContactPersons) // 当前Person的联系人（代表他的人）
        .WithMany(p => p.RepresentedPersons) // 联系人所代表的人（即当前Person）
        .UsingEntity(
            "PersonsAndContacts", // 指定数据库中的连接表名称
            j => j.HasOne<Person>().WithMany().HasForeignKey("IDContactPerson"), // 连接表IDContactPerson对应联系人的Id
            j => j.HasOne<Person>().WithMany().HasForeignKey("IDPerson"), // 连接表IDPerson对应被代表者的Id
            j =>
            {
                // 配置连接表的复合主键
                j.HasKey("IDPerson", "IDContactPerson");
            }
        );

    // 告知EF Core使用私有集合字段进行数据操作
    contactRelationship.Metadata.PrincipalToDependent.SetField("_contactPersons");
    contactRelationship.Metadata.DependentToPrincipal.SetField("_representedPersons");
});

关键说明 #

• 连接表主键：必须显式配置复合主键(IDPerson, IDContactPerson)，避免EF Core生成默认主键与现有表结构冲突。
• 私有字段映射：通过SetField方法保证EF Core使用私有集合字段修改数据，公开的IReadOnlyCollection仅用于读取，符合封装设计。
• 关系方向：HasMany(p => p.ContactPersons)对应连接表的IDPerson（被代表者），WithMany(p => p.RepresentedPersons)对应连接表的IDContactPerson（代表者），完全匹配你的业务逻辑与数据库结构。

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