.NET Core清洁架构中如何将实体类Id替换为领域实体名+Id字段？

方案1：属性封装（推荐） #

核心思路是将自定义的XXXId作为继承自Entity的Id字段的包装属性，EF仅映射底层的Id字段到数据库对应列，领域层通过XXXId访问标识，既避免EF映射冲突，又满足领域命名需求。

实体类代码 #

public class Directory : AggregateRoot  
{       
    // 封装继承的Id字段，对外暴露领域友好的名称
    public int DirectoryId 
    { 
        get => Id; 
        init => Id = value; 
    }       
    public string Name { get; init; } = string.Empty;   
}

// 基类保持原有结构
public abstract class Entity
{
    public int Id { get; protected init; }
}

public abstract class AggregateRoot : Entity { }

EF Core配置 #

public void Configure(EntityTypeBuilder<Directory> builder)     
{       
    // 仅配置继承的Id字段，映射到数据库的DirectoryId列
    builder.Property(x => x.Id)
           .HasColumnName("DirectoryId")
           .ValueGeneratedOnAdd(); // 根据业务需求调整值生成策略，手动赋值用ValueGeneratedNever()
}

原理说明

• 自定义的DirectoryId并非EF Core的映射属性，只是对Id的包装，不会触发多属性映射同一列的异常。
• 从数据库加载实体时，EF会给Id赋值，DirectoryId通过getter自动获取正确值；创建实体时，设置DirectoryId等价于设置底层的Id，完全符合EF的实体跟踪逻辑。

方案2：泛型基类重构（适合新架构初期） #

如果项目处于初期阶段，可以重构基类为泛型，让每个实体指定专属的标识类型，再通过封装实现领域友好的属性名：

重构基类 #

public abstract class Entity<TId>
{
    public TId Id { get; protected init; }
}

public abstract class AggregateRoot<TId> : Entity<TId> { }

实体类实现 #

public class Directory : AggregateRoot<int>  
{       
    // 同样通过封装实现DirectoryId的访问
    public int DirectoryId 
    { 
        get => Id; 
        init => Id = value; 
    }     
    public string Name { get; init; } = string.Empty;   
}

// EF配置逻辑和方案1一致
public void Configure(EntityTypeBuilder<Directory> builder)     
{       
    builder.Property(x => x.Id)
           .HasColumnName("DirectoryId")
           .ValueGeneratedOnAdd();
}

注意

这种方案需要修改所有继承基类的实体，适合架构初期调整；如果项目已有大量实体，方案1的改造成本更低。

为什么之前的方法失败 #

• 双属性映射同一列：EF Core不允许同一实体类型的多个属性映射到数据库同一列，会导致数据同步和实体跟踪的歧义。
• [NotMapped]特性：标记后EF会完全忽略该属性，不会从数据库读取值或写入值，所以DirectoryId始终保持默认值0。

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