EF Core 6如何配置导航属性实现Users表左外连接查询UserDefaultSources

解决步骤 #

1. 实体定义调整 #

首先保证两个实体的属性符合关联要求，注意可空引用类型的标记：

// 用户实体
public class User
{
    public int UserId { get; set; }
    // 必填关联字段
    public string AccountId { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    // 其他原有导航属性（Region、Country等）略
    // 可选导航属性，加?标记可空，无匹配记录时为null
    public UserDefaultSource? UserDefaultSource { get; set; }
}

// 默认支付源实体
public class UserDefaultSource
{
    // 既是当前表主键，也是关联User的外键
    public string AccountId { get; set; }
    // 其他业务字段（支付token等）略
    // 反向导航属性，不需要可以省略
    public User User { get; set; }
}

2. 关联关系配置（推荐Fluent API方式） #

在你项目的DbContext类的OnModelCreating方法中添加如下配置，明确一对一可选关联规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 原有其他配置略
    
    modelBuilder.Entity<User>(entity =>
    {
        entity.HasKey(u => u.UserId);
        entity.Property(u => u.AccountId).IsRequired();
        // 配置一对一可选关联
        entity.HasOne(u => u.UserDefaultSource)
              // 如果UserDefaultSource没有写反向导航属性，这里改成.WithOne()即可
              .WithOne(uds => uds.User)
              // 指定依赖表UserDefaultSource的外键为AccountId
              .HasForeignKey<UserDefaultSource>(uds => uds.AccountId)
              // 标记关联是可选的，生成左外连接而非内连接
              .IsRequired(false);
    });

    modelBuilder.Entity<UserDefaultSource>(entity =>
    {
        entity.HasKey(uds => uds.AccountId);
    });
}

如果你偏好数据注解配置，也可以直接在UserDefaultSource的主键字段上添加标记，无需修改OnModelCreating：

public class UserDefaultSource
{
    [Key]
    [ForeignKey(nameof(User))]
    public string AccountId { get; set; }
    // 其他属性略
}

3. 验证效果 #

配置完成后你原有查询代码无需任何修改，EF Core会自动生成和你手写逻辑一致的左外连接SQL，存在匹配的UserDefaultSources记录时自动填充导航属性，无匹配时UserDefaultSource属性为null。

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