如何使用Entity Framework Core配置User与CognitoUser的单向关联

先明确你的实体定义：

User实体

public class User: Entity
{
    public string Gender { get; set; }
    public string Name { get; set; }
}

CognitoUser实体

public class CognitoUser : Entity
{
    public string UserId { get; set; }
    public User User{ get; set; }
    public string CognitoName { get; set; }
}

你的需求是让CognitoUser.UserId关联User.Id，且User中不添加CognitoUser的引用，原配置失效的核心原因是外键配置方向搞反了，修正后的配置如下：

正确配置（一对一共享主键场景） #

因为你把UserId设为CognitoUser的主键，这属于一对一共享主键关联（CognitoUser的主键同时作为关联User的外键），配置代码：

modelBuilder.Entity<CognitoUser>(e =>
{
    e.ToTable("CognitoUser");
    e.HasKey(p => p.UserId); // 保持UserId作为CognitoUser的主键

    // 配置单向关联：CognitoUser -> User，User无反向导航
    e.HasOne(x => x.User)
      .WithOne() // 无参数表示User中没有对应的导航属性
      .HasForeignKey<CognitoUser>(c => c.UserId); // 外键是CognitoUser的UserId，关联User的Id
});

错误原因分析 #

原代码中HasForeignKey<User>(c => c.Id)是错误的：

• 这个写法是告诉EF，外键字段在User实体的Id上，但实际外键应该在CognitoUser这边（即UserId字段）
• 同时因为不需要User的反向导航，必须用WithOne()无参数重载，明确这是单向关联

可选：一对多场景（如果CognitoUser有独立主键） #

如果你希望CognitoUser有自己的独立主键（比如继承自Entity的Id），UserId仅作为外键，配置如下：

modelBuilder.Entity<CognitoUser>(e =>
{
    e.ToTable("CognitoUser");
    // 此处使用Entity基类的Id作为CognitoUser的主键，保留UserId作为外键
    e.HasKey(p => p.Id);

    e.HasOne(x => x.User)
      .WithMany() // 无参数表示User中没有对应的集合导航属性
      .HasForeignKey(c => c.UserId) // 外键是CognitoUser的UserId
      .OnDelete(DeleteBehavior.Cascade); // 可选：设置级联删除规则
});

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