EF Core CodeFirst模式下能否通过接口实现实体多态映射？

报错根因 #

EF Core 无法直接将接口类型识别为合法的导航属性类型，导航属性需要绑定到已配置映射规则的具体实体类型，接口本身不存在对应的表映射配置，因此触发构建错误。

可选实现方案 #

你不需要强行把所有属性合并到统一实体类，有三种成熟的实现方案可按需选择：

方案1：使用EF Core原生支持的类继承体系（推荐） #

将原IEntityModel接口改为抽象基类，EF Core 支持三种继承映射策略，可根据业务场景选型：

• TPH（表每层次结构）：所有子类字段都存储在同一张表中，通过discriminator内置字段区分子类类型，适合子类字段差异小的场景，查询性能最优
• TPT（表每类型）：公共字段存储在基类对应表中，子类独有字段存储在各自的子类表中，查询时自动关联获取，适合子类字段差异较大的场景
• TPCC（表每具体类）：每个子类对应独立的表，公共字段会在每个子类表中重复存储，不需要单独查询基类实体的场景可使用

代码调整示例：

// 替换原有IEntityModel接口为抽象基类
public abstract class EntityModelBase
{
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public Guid EntityId { get; set; }
    public PostalAddress PrincipalAddress { get; set; }
}

public class CompanyEntity : EntityModelBase
{
    public string CompanyName { get; set; }
}

public class PersonEntity : EntityModelBase
{
    public string FirstNames { get; set; }
    public string Surname { get; set; }
}

// 调整CaseEntity的导航属性类型为抽象基类
public class CaseEntity
{
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int CaseEntityId { get; set; }
    
    public int CaseId { get; set; }
    public CaseModel Case { get; set; }
    public Guid EntityId { get; set; }
    public EntityModelBase Entity { get; set; }
}

调整后不需要额外配置即可默认使用TPH策略，若需要切换为TPT/TPCC，只需在OnModelCreating方法中配置对应继承规则即可。

方案2：保留接口设计，拆分导航属性 #

如果必须保留IEntityModel接口的架构设计，可以拆分出两个明确类型的导航属性，额外增加一个非映射的接口属性用于业务层统一访问：

public class CaseEntity
{
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int CaseEntityId { get; set; }
    
    public int CaseId { get; set; }
    public CaseModel Case { get; set; }
    public Guid? PersonEntityId { get; set; }
    public PersonEntity? PersonEntity { get; set; }
    public Guid? CompanyEntityId { get; set; }
    public CompanyEntity? CompanyEntity { get; set; }

    // 不映射到数据库，仅用于业务层统一访问实体
    [NotMapped]
    public IEntityModel Entity 
    {
        get => PersonEntity as IEntityModel ?? CompanyEntity as IEntityModel;
        set
        {
            PersonEntity = value as PersonEntity;
            CompanyEntity = value as CompanyEntity;
        }
    }
}

该方案的缺点是表中会新增两个可空外键字段，业务逻辑中需要确保每次仅对一个外键赋值，避免数据冲突。

方案3：合并为统一实体类 #

如果个人和企业两类实体的字段差异极小，可以用单一实体类包含所有字段，新增枚举字段区分实体类型即可：

public enum EntityType
{
    Person,
    Company
}

public class EntityModel : IEntityModel
{
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public Guid EntityId { get; set; }
    public EntityType Type { get; set; }
    public PostalAddress PrincipalAddress { get; set; }
    // 个人类型专属字段，企业类型下可为空
    public string? FirstNames { get; set; }
    public string? Surname { get; set; }
    // 企业类型专属字段，个人类型下可为空
    public string? CompanyName { get; set; }
}

该方案实现成本最低、查询性能最高，缺点是表中会存在大量空值字段，实体字段较多时冗余度较高。

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