EF Core双向可选一对一关系配置：支持外键可空、主表无匹配记录

核心逻辑说明 #

你需要的是依赖端为Foo、主体端为Bar的可选一对一关系：外键存放在Foo表的BarId字段，通过唯一约束保证一个Bar最多被一个Foo关联，同时Bar无需设置外键即可独立存在。

方式1：Fluent API实现（推荐） #

在你的DbContext的OnModelCreating方法中添加如下配置即可：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置一对一关系
    modelBuilder.Entity<Foo>()
        .HasOne(f => f.Bar)
        .WithOne(b => b.Foo)
        .HasForeignKey<Foo>(f => f.BarId) // 指定外键挂载在Foo的BarId字段
        .IsRequired(false); // 明确BarId允许为null

    // 给BarId添加带过滤的唯一索引，保证一对一关系同时允许多个Foo的BarId为null
    modelBuilder.Entity<Foo>()
        .HasIndex(f => f.BarId)
        .IsUnique()
        // 仅对非null的BarId做唯一性校验，兼容SQL Server等数据库唯一索引默认仅允许一个null值的问题
        .HasFilter("[BarId] IS NOT NULL");
}

方式2：DataAnnotations实现 #

直接在实体属性上添加特性即可完成配置：

public class Foo
{
    public long Id { get; set; }
    
    [ForeignKey(nameof(Bar))]
    // EF Core 5+支持Index特性，需要引用Microsoft.EntityFrameworkCore包
    [Index(IsUnique = true, Filter = "[BarId] IS NOT NULL")]
    public long? BarId { get; set; }
    public virtual Bar? Bar { get; set; }
}

public class Bar
{
    public long Id { get; set; }
    
    [InverseProperty(nameof(Foo.Bar))]
    public virtual Foo? Foo { get; set;}
}

配置效果验证 #

完全匹配你的需求场景：

• Foo的BarId可以为null，支持多个Foo同时不关联Bar
• Bar表可以插入任意无对应Foo关联的独立记录
• 非null的BarId全局唯一，保证一个Bar最多只能被一个Foo关联，严格符合一对一关系要求

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