EF Core 6中多C#实体映射单数据库表的配置及错误解决

需求背景 #

要将两个C#实体映射到同一个数据库表Opportunity：

• Opportunity：包含全部约60个属性
• OpportunitySummary：仅包含其中10个常用属性，与Opportunity存在属性重叠

要求可以直接通过Opportunity.PropertyA和OpportunitySummary.PropertyA访问对应属性，拒绝采用Opportunity.OpportunitySummary.PropertyA这种嵌套成员的方案。

现有配置及问题 #

在DbContext的OnModelCreating()方法中编写了如下配置：

// map both classes to the same DB table
modelBuilder.Entity<Opportunity>().ToTable("Opportunity");
modelBuilder.Entity<OpportunitySummary>().ToTable("Opportunity");

// Configure Opportunity -> OpportunitySummary 1:1 relationship
modelBuilder.Entity<OpportunitySummary>()
            .HasOne<Opportunity>()
            .WithMany()
            .HasForeignKey(os => os.ID)
            .HasPrincipalKey(o => o.ID);

运行时触发错误：未找到'Opportunity.ID2'属性，但代码中并未定义该属性。

正确配置方案 #

问题出在关系配置错误：使用WithMany()会让EF Core认为是一对多关联，自动尝试生成额外的外键列（如ID2），而表拆分需要的是一对一关系。正确的Fluent API配置如下：

// 配置两个实体映射到同一个数据库表
modelBuilder.Entity<Opportunity>().ToTable("Opportunity");
modelBuilder.Entity<OpportunitySummary>().ToTable("Opportunity");

// 配置一对一共享主键关系
modelBuilder.Entity<Opportunity>()
    .HasOne<OpportunitySummary>() // Opportunity对应一个OpportunitySummary
    .WithOne() // OpportunitySummary对应一个Opportunity
    .HasForeignKey<OpportunitySummary>(os => os.ID) // 用OpportunitySummary的ID作为外键
    .HasPrincipalKey<Opportunity>(o => o.ID); // 关联Opportunity的主键ID

关键说明 #

1. 共享主键：确保两个实体的主键属性（如ID）名称、类型完全一致，EF Core会通过主键关联两个实体，无需额外外键列
2. 一对一关系：使用WithOne()替代WithMany()，明确两个实体是一对一映射，避免EF自动生成多余的外键字段
3. 查询优化：查询OpportunitySummary时，EF Core会自动只查询该实体包含的属性对应的列，达到只获取部分字段的目的

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