EF Core 8映射含接口复杂类型：非接口引用类型错误解决

针对你遇到的「指定类型'IKey'必须是非接口引用类型才能用作实体类型」错误，结合无法修改原类和接口的限制，以下是正确的映射配置方案：

核心问题分析 #

EF Core 无法直接将接口作为实体类型或导航属性的目标类型，必须明确指定接口对应的具体实现类，并通过实体关系配置替代直接的接口引用映射。

修正后的映射配置代码 #

public DbSet<AasCore.Aas3_0.Key> KeyDbSets { get; set; }
public DbSet<AasCore.Aas3_0.Reference> ReferenceDbSets { get; set; }

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 配置Key实体主键
    modelBuilder.Entity<Key>()
        .HasKey(k => k.Value);

    // 配置Reference与Key的一对多关系
    modelBuilder.Entity<Reference>()
        .HasMany<Key>() // 指定关联的实体为具体类Key
        .WithOne()      // Key无反向导航属性
        .HasForeignKey("ReferenceId") // 自动生成外键列
        .OnDelete(DeleteBehavior.Cascade);

    // 关联Reference的Keys接口属性到上述关系
    var keysNavigation = modelBuilder.Entity<Reference>().Metadata.FindNavigation(nameof(Reference.Keys))!;
    keysNavigation.SetTargetEntityType(modelBuilder.Entity<Key>().Metadata);
    keysNavigation.SetPropertyAccessMode(PropertyAccessMode.Property);

    // 配置Reference的自引用关系（ReferredSemanticId）
    modelBuilder.Entity<Reference>()
        .HasOne<Reference>() // 指定关联的实体为具体类Reference
        .WithMany()          // 一个Reference可被多个实例引用
        .HasForeignKey("ReferredSemanticId") // 自动生成外键列
        .IsRequired(false)
        .OnDelete(DeleteBehavior.Restrict); // 避免循环删除

    // 关联Reference的ReferredSemanticId接口属性到上述自引用关系
    var semanticIdNavigation = modelBuilder.Entity<Reference>().Metadata.FindNavigation(nameof(Reference.ReferredSemanticId))!;
    semanticIdNavigation.SetTargetEntityType(modelBuilder.Entity<Reference>().Metadata);
    semanticIdNavigation.SetPropertyAccessMode(PropertyAccessMode.Property);
}

// 移除原ConfigureConventions中的集合转换器（导航属性无需值转换器）

关键配置说明 #

1. 避免接口直接作为导航目标：通过泛型方法HasMany<Key>、HasOne<Reference>明确指定实体的具体实现类，而非接口类型。
2. 关联接口属性到实体关系：通过SetTargetEntityType将接口类型的属性（如List<IKey>、IReference?）关联到具体实体的导航关系上。
3. 手动指定外键列：由于原类中无外键属性，EF会自动在数据库中生成ReferenceId、ReferredSemanticId列。
4. 设置合理的删除行为：自引用关系使用DeleteBehavior.Restrict防止循环删除报错。

额外验证（可选） #

可在DbContext初始化时添加模型验证，确保配置正确：

modelBuilder.Model.Validate();

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