EF Code First仅依赖端到主体端导航属性的一对一关系配置问题

问题背景 #

现有两个实体类，需要通过EF Fluent API配置必填的一对一关系：

// 主体实体（父级）
class Blog
{
  public int Id {get; set;}
}

// 依赖实体（子级）
public class BlogHeader
{
  public int Id {get; set;}
  public Blog Blog {get; set;} // 指向主体的导航属性
}

尝试了以下配置代码，但添加迁移时抛出异常：

internal class BlogHeaderConfiguration : IEntityTypeConfiguration<BlogHeader>
{
    public void Configure(EntityTypeBuilder<BlogHeader> builder)
    {
        builder.ToTable("BlogHeaders");
        builder.HasKey(x => x.Id);
        
        builder.HasOne(x => x.Blog).WithOne().HasForeignKey<BlogHeader>(x => x.Blog);
    }
}

异常信息：

“Blog”不能用作“BlogHeader”实体类型的属性，因为它已被配置为导航属性。

错误原因 #

代码中HasForeignKey<BlogHeader>(x => x.Blog)的用法错误：x.Blog是导航属性，而HasForeignKey需要接收的是标量类型的外键属性（比如int类型的BlogId），EF无法将导航属性映射为数据库外键列，因此报错。

正确配置方案 #

方案1：显式添加外键属性（推荐） #

先修改BlogHeader类，添加对应的外键属性：

public class BlogHeader
{
  public int Id {get; set;}
  public int BlogId {get; set;} // 显式外键属性
  public Blog Blog {get; set;} // 导航属性
}

然后更新配置类，指定外键并标记为必填：

internal class BlogHeaderConfiguration : IEntityTypeConfiguration<BlogHeader>
{
    public void Configure(EntityTypeBuilder<BlogHeader> builder)
    {
        builder.ToTable("BlogHeaders");
        builder.HasKey(x => x.Id);
        
        // 配置一对一关系：BlogHeader依赖于Blog，外键为BlogId且必填
        builder.HasOne(x => x.Blog)
               .WithOne() // Blog无反向导航属性，直接用WithOne()
               .HasForeignKey<BlogHeader>(x => x.BlogId)
               .IsRequired(); // 标记外键为必填，确保关系强制存在
    }
}

方案2：使用阴影属性（无需修改实体类） #

如果不想在实体类中显式添加外键属性，可以用EF的阴影属性来存储外键：

internal class BlogHeaderConfiguration : IEntityTypeConfiguration<BlogHeader>
{
    public void Configure(EntityTypeBuilder<BlogHeader> builder)
    {
        builder.ToTable("BlogHeaders");
        builder.HasKey(x => x.Id);
        
        // 配置一对一关系，使用名为BlogId的阴影属性作为外键
        builder.HasOne(x => x.Blog)
               .WithOne()
               .HasForeignKey<BlogHeader>("BlogId") // 指定阴影属性名称
               .IsRequired();
    }
}

这样配置后，EF会在数据库中为BlogHeaders表创建BlogId列，作为外键关联Blogs表的Id，且该列不允许为null，实现必填的一对一关系。

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