EF Core错误推断非预期实体关系，迁移构建时异常

问题分析 #

你遇到的两个错误根源在于：

1. 实体字段未被EF正确识别：代码中实体类使用字段（如public Guid Id;）而非属性，EF Core 6默认不会自动映射公共字段，导致无法正确识别主键和外键。
2. 自引用导航关系混淆：User继承UserEditable后，拥有两个指向自身的导航属性（CreateUser/ModifyUser），未明确区分两个独立关系，EF无法识别这是两个不同的多对一关联。
3. 配置类语法错误：存在大小写错误（haskey→HasKey）、拼写错误（overrider→override），导致配置无法正确加载。

解决方案 #

1. 实体类改为属性映射 #

将实体中的字段改为带get/set的属性，这是EF Core的标准映射方式：

public class BaseEntity
{
    public Guid Id { get; set; }
}

public class UserEditable : BaseEntity
{
    public Guid CreatedUserId { get; set; }
    public Guid ModifyUserId { get; set; }

    public User CreateUser { get; set; }
    public User ModifyUser { get; set; }
}

public class User : UserEditable
{
    // 示例User专属属性
    public string Username { get; set; }
    public string Email { get; set; }
}

2. 修正配置类并明确关系区分 #

修正语法错误，同时给两个外键约束指定唯一名称，帮助EF识别独立关系：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;

public abstract class BaseEntityConfiguration<T> : IEntityTypeConfiguration<T>
    where T : BaseEntity
{
    public virtual void Configure(EntityTypeBuilder<T> builder)
    {
        builder.HasKey(k => k.Id);
    }
}

// 重命名配置类避免与实体类冲突
public abstract class UserEditableConfiguration<T> : BaseEntityConfiguration<T>
    where T : UserEditable
{
    public override void Configure(EntityTypeBuilder<T> builder)
    {
        base.Configure(builder);

        // 配置CreateUser关联，指定唯一约束名
        builder.HasOne(o => o.CreateUser)
            .WithMany()
            .HasForeignKey(f => f.CreatedUserId)
            .HasPrincipalKey(p => p.Id)
            .OnDelete(DeleteBehavior.Restrict)
            .HasConstraintName("FK_UserEditable_CreateUser");

        // 配置ModifyUser关联，指定不同约束名
        builder.HasOne(o => o.ModifyUser)
            .WithMany()
            .HasForeignKey(f => f.ModifyUserId)
            .HasPrincipalKey(p => p.Id)
            .OnDelete(DeleteBehavior.Restrict)
            .HasConstraintName("FK_UserEditable_ModifyUser");
    }
}

public class UserConfiguration : UserEditableConfiguration<User>
{
    public override void Configure(EntityTypeBuilder<User> builder)
    {
        base.Configure(builder);
        // 添加User专属配置（可选）
        builder.HasIndex(u => u.Username).IsUnique();
        builder.HasIndex(u => u.Email).IsUnique();
    }
}

3. 验证迁移 #

执行迁移命令：

• Package Manager Console：Add-Migration InitialCreate
• .NET CLI：dotnet ef migrations add InitialCreate

此时EF能正确识别两个独立的自引用关系，不会再报之前的错误。

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