EF Core 8.0如何基于OtherId配置Parent与Dependent的关联关系？

错误原因分析 #

你遇到的报错The foreign key must target a type that is part of the relationship主要有两个原因：

• 配置代码中HasForeignKey<Child>()的泛型参数错误，你的依赖实体类是Dependent而非Child
• 实体类缺少必要的主键配置，EF Core无法正确识别实体的标识属性

正确配置步骤 #

1. 修正实体类代码 #

首先修复实体类的语法错误，并明确主键规则：

public class Parent
{
    // 修复语法错误，添加get/set访问器
    public int Id { get; set; }
    public int OtherId { get; set; }        
    public Dependent Child { get; set; }
}

public class Dependent
{
    // 用OtherId作为主键，需保证字段唯一性
    public int OtherId { get; set; }        
    public string Name { get; set; }        
}

2. 正确的Fluent API配置 #

针对一对一关联、使用OtherId作为关联键的正确配置如下：

// 显式配置Dependent的主键为OtherId
modelBuilder.Entity<Dependent>()
    .HasKey(d => d.OtherId);

// 配置Parent与Dependent的一对一关联
modelBuilder.Entity<Parent>()
    .HasOne(p => p.Child)
    .WithOne()
    // 指定依赖端为Dependent，外键字段为OtherId
    .HasForeignKey<Dependent>(d => d.OtherId)
    // 指定主体端Parent的关联匹配字段为OtherId
    .HasPrincipalKey<Parent>(p => p.OtherId)
    .IsRequired(false);

补充说明 #

• 一对一关系中，依赖端的外键通常同时作为主键，以此保证关联的唯一性
• 若业务上不需要OtherId作为Dependent的主键，可单独为Dependent添加Id主键，再新增一个外键字段关联Parent.OtherId，但这种场景更适合设计为一对多关联，需根据实际业务需求调整

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