EF Core如何基于两个名称不同的外键字段定义一对一关系？

核心配置方法 #

你不需要修改现有实体的字段名，仅需在你的DbContext类的OnModelCreating方法中通过Fluent API配置复合外键的一对一关联即可，配置代码如下：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 1. 配置实体主键（如果已有主键可跳过本段，直接看关联配置）
    // 这里以关联字段作为复合主键为例，符合你场景的一对一唯一性约束
    modelBuilder.Entity<Bill>()
        .HasKey(b => new { b.Identifier, b.WebSiteId });
    
    modelBuilder.Entity<Pay>()
        .HasKey(p => new { p.Account, p.WebSiteId });

    // 2. 配置一对一关联关系
    modelBuilder.Entity<Bill>()
        // Bill对应1个Pay实体
        .HasOne(b => b.Pay)
        // Pay对应1个Bill实体
        .WithOne(p => p.Bill)
        // 指定Pay端作为外键持有方，外键为Account+WebSiteId复合字段
        .HasForeignKey<Pay>(p => new { p.Account, p.WebSiteId })
        // 指定Bill端的关联主键，和外键顺序一一对应：Identifier对应Account，WebSiteId对应WebSiteId
        .HasPrincipalKey<Bill>(b => new { b.Identifier, b.WebSiteId });
}

注意事项 #

• 如果你的实体原本已经设置了独立主键（比如自增Id字段），无需修改主键配置，仅需保证Pay表中Account + WebSiteId的组合值唯一即可，关联配置段不需要改动。
• 该配置不会修改现有实体字段名，完全兼容你项目中已有的原生SQL查询，不会产生影响。
• 关联查询时请和你定义的导航属性名保持一致，使用context.Bills.Include(x => x.Pay)即可触发正确的关联查询，生成的SQL逻辑和你手写的关联语句完全一致。

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