Entity Framework Core 公共实体基类配置报错问题求助

两个报错核心是EF Core继承映射规则配置错误，外加实体定义存在冗余：

• 直接调用modelBuilder.Entity<BaseEntity>()配置关系时，EF Core会默认把抽象基类BaseEntity识别为独立的映射实体，默认采用TPH（单表继承）策略，要求提供鉴别器列区分派生类型，你没有配置该策略，就会抛出派生类和基类映射到同一张表的错误。
• User类中定义的ICollection<BaseEntity>类型导航属性，因为基类未被正确映射为可落表的实体，EF Core无法自动推断关系Multiplicity，就会抛出无法确定关系的错误。
• 你当前的User类重复定义了一遍BaseEntity中已经存在的公共审计字段，属于冗余代码，User本身作为业务实体也应该继承BaseEntity。
• 直接在BaseEntity构造函数中赋默认值是错误实现：EF Core从数据库查询实体实例化时也会执行构造函数，会覆盖数据库中存储的原始值，导致数据异常。

第一步：修正实体定义，清理冗余代码 #

1. 让User类直接继承BaseEntity，删除类中重复定义的公共审计字段（CreationDate/CreatedByUserId等）
2. 删除User类中三个ICollection<BaseEntity>类型的导航属性——这类指向抽象基类的集合无法直接映射到物理表，需要查询关联数据时直接通过DbSet按外键过滤即可，无需反向导航集合。

修正后的User类核心代码：

public class User : IdentityUser<Guid>
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int IdentificationNumber { get; set; }
    public string PassportNumber { get; set; }
    public bool Active { get; set; }
    public string DisplayName => FirstName + " " + LastName;
}

BaseEntity类保留原有属性定义即可，但要清空构造函数中的赋值逻辑，避免覆盖数据库值：

public abstract class BaseEntity
{
    public Guid Id { get; set; }
    public DateTime CreationDate { get; set; }
    public Guid CreatedByUserId { get; set; }
    public DateTime UpdateDate { get; set; }
    public Guid UpdateByUserId { get; set; }
    public bool IsDeleted { get; set; }
    public DateTime DeletedDate { get; set; }
    public Guid DeletedByUserId { get; set; }

    public virtual User? CreatedByUser { get; set; }
    public virtual User? DeletedByUser { get; set; }
    public virtual User? UpdateByUser { get; set; }
}

第二步：统一配置所有派生实体的映射关系 #

不要直接对BaseEntity做实体配置，而是在OnModelCreating中遍历所有继承自BaseEntity的业务实体，逐个统一配置公共属性和外键关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    // 保留你原有的Identity表、其他业务实体的配置代码

    // 筛选所有继承BaseEntity的非抽象业务实体
    var derivedEntityTypes = modelBuilder.Model.GetEntityTypes()
        .Where(t => t.ClrType.IsSubclassOf(typeof(BaseEntity)) && !t.ClrType.IsAbstract);

    foreach (var entityType in derivedEntityTypes)
    {
        var builder = modelBuilder.Entity(entityType.ClrType);

        // 配置创建人外键
        builder.HasOne(typeof(User), nameof(BaseEntity.CreatedByUser))
            .WithMany()
            .HasForeignKey(nameof(BaseEntity.CreatedByUserId))
            .OnDelete(DeleteBehavior.ClientSetNull)
            .IsRequired(false)
            .HasConstraintName($"FK_{entityType.ClrType.Name}_User_CreatedBy");

        // 配置修改人外键
        builder.HasOne(typeof(User), nameof(BaseEntity.UpdateByUser))
            .WithMany()
            .HasForeignKey(nameof(BaseEntity.UpdateByUserId))
            .OnDelete(DeleteBehavior.ClientSetNull)
            .IsRequired(false)
            .HasConstraintName($"FK_{entityType.ClrType.Name}_User_UpdatedBy");

        // 配置删除人外键
        builder.HasOne(typeof(User), nameof(BaseEntity.DeletedByUser))
            .WithMany()
            .HasForeignKey(nameof(BaseEntity.DeletedByUserId))
            .OnDelete(DeleteBehavior.ClientSetNull)
            .IsRequired(false)
            .HasConstraintName($"FK_{entityType.ClrType.Name}_User_DeletedBy");

        // 可选：统一配置全局软删除查询过滤器，默认查询自动过滤已删除数据
        var parameter = System.Linq.Expressions.Expression.Parameter(entityType.ClrType, "e");
        var filter = System.Linq.Expressions.Expression.Lambda(
            System.Linq.Expressions.Expression.Equal(
                System.Linq.Expressions.Expression.Property(parameter, nameof(BaseEntity.IsDeleted)),
                System.Linq.Expressions.Expression.Constant(false)
            ), parameter
        );
        builder.HasQueryFilter(filter);
    }
}

第三步：统一公共字段赋值逻辑 #

不要在构造函数中给审计字段赋值，重写DbContext的SaveChanges和SaveChangesAsync方法，在数据提交前统一给新增、修改、软删除的实体赋值：

public override int SaveChanges()
{
    FillAuditFields();
    return base.SaveChanges();
}

public override Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
{
    FillAuditFields();
    return base.SaveChangesAsync(cancellationToken);
}

private void FillAuditFields()
{
    // 替换为你自己系统中获取当前登录用户ID的逻辑
    Guid currentUserId = GetCurrentLoginUserId();
    // 建议统一使用UTC时间存储，避免跨时区问题，前端展示时再转本地时间
    DateTime now = DateTime.UtcNow;

    foreach (var entry in ChangeTracker.Entries<BaseEntity>())
    {
        switch (entry.State)
        {
            case EntityState.Added:
                entry.Entity.Id = Guid.NewGuid();
                entry.Entity.CreationDate = now;
                entry.Entity.CreatedByUserId = currentUserId;
                entry.Entity.UpdateDate = now;
                entry.Entity.UpdateByUserId = currentUserId;
                entry.Entity.IsDeleted = false;
                entry.Entity.DeletedDate = new DateTime(1, 1, 1);
                entry.Entity.DeletedByUserId = Guid.Empty;
                break;
            case EntityState.Modified:
                // 锁定创建字段不允许修改，避免业务代码篡改
                entry.Property(x => x.CreationDate).IsModified = false;
                entry.Property(x => x.CreatedByUserId).IsModified = false;
                entry.Entity.UpdateDate = now;
                entry.Entity.UpdateByUserId = currentUserId;
                // 软删除时自动填充删除信息
                if (entry.Property(x => x.IsDeleted).IsModified && entry.Entity.IsDeleted)
                {
                    entry.Entity.DeletedDate = now;
                    entry.Entity.DeletedByUserId = currentUserId;
                }
                break;
        }
    }
}

• 不要给BaseEntity添加[NotMapped]特性，只要你不直接调用modelBuilder.Entity<BaseEntity>()将其注册为独立映射实体，EF Core会自动识别它作为抽象基类，将其属性映射到所有派生实体对应的物理表中。
• 时间字段尽量统一使用DateTime.UtcNow存储，不要直接用DateTime.Now，避免服务器时区切换、多地域部署导致的时间错乱问题。
• 如果需要查询某用户关联的所有业务数据，直接通过对应实体的DbSet按外键条件过滤即可，不需要在User类上定义指向基类的集合导航。

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