Entity Framework Core如何通过Fluent Mapping统一配置多实体的公共基类属性

嘿，我懂你现在的烦恼——重复写一模一样的配置代码不仅繁琐，还容易出错，确实不够规范。EF Core其实有几种很优雅的方式来统一处理继承自抽象基类的实体配置，我给你详细拆解一下：

方法1：使用泛型扩展方法（最简洁的方式） #

我们可以创建一个泛型扩展方法，把所有BaseCodeEntity的公共属性配置封装起来，然后在每个实体的配置中直接调用这个方法，只需要单独配置每个实体独有的部分（比如主键）。

首先定义扩展方法：

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

public static class BaseCodeEntityConfigurationExtensions
{
    public static void ConfigureBaseCodeEntity<TEntity>(this EntityTypeBuilder<TEntity> builder)
        where TEntity : BaseCodeEntity
    {
        // 配置Code属性：必填，最大长度50（可根据你的需求调整）
        builder.Property(e => e.Code)
            .IsRequired()
            .HasMaxLength(50);

        // 配置Name属性：必填，最大长度100
        builder.Property(e => e.Name)
            .IsRequired()
            .HasMaxLength(100);

        // 配置Description属性：可选，最大长度500
        builder.Property(e => e.Description)
            .HasMaxLength(500);

        // 配置创建相关属性
        builder.Property(e => e.CreatedBy)
            .IsRequired()
            .HasMaxLength(50);

        builder.Property(e => e.Created)
            .IsRequired();

        // 配置修改相关属性
        builder.Property(e => e.ModifiedBy)
            .IsRequired()
            .HasMaxLength(50);

        builder.Property(e => e.Modified)
            .IsRequired();

        // 配置禁用状态
        builder.Property(e => e.Disabled)
            .IsRequired();

        // 配置行版本（就是你之前重复写的Timestamp）
        builder.Property(e => e.Timestamp)
            .IsRequired()
            .IsRowVersion();
    }
}

然后在OnModelCreating中简化每个实体的配置：

protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 
    modelBuilder.Entity<CompanyCode>(entity => { 
        entity.HasKey(x => x.CompanyCodeId);
        entity.ConfigureBaseCodeEntity(); // 一键应用公共配置
    }); 

    modelBuilder.Entity<CostCenterCode>(entity => { 
        entity.HasKey(x => x.CostCenterCodeId);
        entity.ConfigureBaseCodeEntity();
    }); 

    modelBuilder.Entity<DisciplineCode>(entity => { 
        entity.HasKey(x => x.DisciplineCodeId);
        entity.ConfigureBaseCodeEntity();
    }); 

    modelBuilder.Entity<SubDisciplineCode>(entity => { 
        entity.HasKey(x => x.SubDisciplineCodeId);
        entity.ConfigureBaseCodeEntity();
    }); 
}

方法2：使用IEntityTypeConfiguration<T>抽象基类（更符合EF配置惯例） #

如果喜欢用EF推荐的配置类模式，可以创建一个抽象的配置基类，封装公共属性配置，然后每个实体的配置类继承这个基类，只需要重写配置独有的部分。

首先创建抽象配置基类：

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

public abstract class BaseCodeEntityConfiguration<TEntity> : IEntityTypeConfiguration<TEntity>
    where TEntity : BaseCodeEntity
{
    public virtual void Configure(EntityTypeBuilder<TEntity> builder)
    {
        // 和扩展方法里一样的公共属性配置
        builder.Property(e => e.Code)
            .IsRequired()
            .HasMaxLength(50);

        builder.Property(e => e.Name)
            .IsRequired()
            .HasMaxLength(100);

        // ...省略其他公共属性配置，和上面一致

        builder.Property(e => e.Timestamp)
            .IsRequired()
            .IsRowVersion();
    }
}

然后每个实体的配置类继承这个基类：

public class CompanyCodeConfiguration : BaseCodeEntityConfiguration<CompanyCode>
{
    public override void Configure(EntityTypeBuilder<CompanyCode> builder)
    {
        base.Configure(builder); // 先应用公共配置
        builder.HasKey(x => x.CompanyCodeId); // 配置当前实体的主键
    }
}

// 同理创建其他实体的配置类
public class CostCenterCodeConfiguration : BaseCodeEntityConfiguration<CostCenterCode>
{
    public override void Configure(EntityTypeBuilder<CostCenterCode> builder)
    {
        base.Configure(builder);
        builder.HasKey(x => x.CostCenterCodeId);
    }
}

最后在OnModelCreating中注册这些配置类：

protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 
    // 手动注册每个配置类，或者用批量扫描的方式（如果配置类很多）
    modelBuilder.ApplyConfiguration(new CompanyCodeConfiguration());
    modelBuilder.ApplyConfiguration(new CostCenterCodeConfiguration());
    modelBuilder.ApplyConfiguration(new DisciplineCodeConfiguration());
    modelBuilder.ApplyConfiguration(new SubDisciplineCodeConfiguration());
}

方法3：批量自动配置（适合新增实体无需手动修改配置） #

如果你的实体主键命名有规律（比如都是[实体名]Id，比如CompanyCodeId、CostCenterCodeId），还可以通过反射批量找到所有继承BaseCodeEntity的实体，自动配置公共属性和主键，这样以后新增实体时不需要修改OnModelCreating。

protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 
    // 获取所有继承自BaseCodeEntity的实体类型
    var baseCodeEntityTypes = modelBuilder.Model.GetEntityTypes()
        .Where(t => typeof(BaseCodeEntity).IsAssignableFrom(t.ClrType));

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

        // 配置公共属性，用nameof避免硬编码
        builder.Property(nameof(BaseCodeEntity.Code))
            .IsRequired()
            .HasMaxLength(50);

        builder.Property(nameof(BaseCodeEntity.Name))
            .IsRequired()
            .HasMaxLength(100);

        // ...省略其他公共属性配置

        builder.Property(nameof(BaseCodeEntity.Timestamp))
            .IsRequired()
            .IsRowVersion();

        // 根据命名规律自动配置主键
        var primaryKeyPropertyName = $"{entityType.ClrType.Name}Id";
        var primaryKeyProperty = entityType.ClrType.GetProperty(primaryKeyPropertyName);
        
        if (primaryKeyProperty != null)
        {
            builder.HasKey(primaryKeyPropertyName);
        }
    }
}

总结 #

• 如果只是想快速简化现有代码，方法1是最直接的选择；
• 如果更倾向于EF的结构化配置模式，方法2更符合最佳实践；
• 如果需要新增实体时零配置，且主键命名有规律，方法3会非常省心。

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