EF Core使用Include后关联导航属性返回null的问题排查

• EF Core的导航属性加载是显式分层的，不会无差别自动加载所有层级的关联对象。你当前的查询只通过.Include(t => t.Transactions)指定加载当前用户关联的Transaction集合，并没有额外指定要加载Transaction实体下的Patient导航属性，因此这部分数据默认不会被查询出来，表现为null。
• 实体关系配置存在映射缺失。目前你仅配置了Transaction和User之间「交易发起方」的一对多关联，但Transaction上的Patient属性同样指向User实体，属于另一组独立的一对多关系，你没有对这组关系做显式映射。之前你尝试补充配置时遇到的报错，本质是把配置的实体主体搞反了：你在User实体的配置块里试图添加一个User实体本身不存在的导航映射，EF Core自然无法识别。
• 你看到数据可以正常保存，是因为EF Core遵循约定自动识别了Transaction上两个指向User的引用导航，自动生成了UserUserId、PatientUserId两个外键列，保证外键值可以正确落库。但这种自动约定的映射，没有对应显式的导航配置，即便后续做嵌套加载，也可能出现导航匹配失效的问题。

第一步：补全关系映射配置 #

你之前想写的Patient关联配置不需要放在User实体的配置块里，要以Transaction为实体主体完成映射，根据你是否需要反向导航分两种情况处理：

• 场景1：不需要在User实体上维护「我作为患者参与的所有交易」集合
  直接在Transaction的实体配置块中映射对应外键即可，不需要额外给User加导航属性：

  modelBuilder.Entity<Transaction>(entity =>
  {
      // 原有交易发起方的关联配置
      entity.HasOne(t => t.User)
          .WithMany(u => u.Transactions)
          .HasForeignKey(t => t.UserUserId);
      
      // 新增Patient关联配置，因为无反向导航，WithMany后留空即可
      entity.HasOne(t => t.Patient)
          .WithMany()
          .HasForeignKey(t => t.PatientUserId);
  });
  

• 场景2：需要在User实体上维护「我作为患者参与的所有交易」集合
  先给User实体补充对应的集合导航属性：

  public class User
  {
      public long UserId { get; set; }
      public string Name { get; set; }
      // 作为交易发起方的交易集合
      public IList<Transaction> Transactions { get; set; }
      // 作为患者参与的交易集合
      public IList<Transaction> PatientTransactions { get; set; }
  }
  

  再在Transaction的配置块中把关联关系映射完整：

  modelBuilder.Entity<Transaction>(entity =>
  {
      entity.HasOne(t => t.User)
          .WithMany(u => u.Transactions)
          .HasForeignKey(t => t.UserUserId);
      
      entity.HasOne(t => t.Patient)
          .WithMany(u => u.PatientTransactions)
          .HasForeignKey(t => t.PatientUserId);
  });
  

第二步：调整查询语句，通过嵌套加载获取Patient导航 #

EF Core支持通过ThenInclude做跨层级的导航属性加载，你之前的查询只加载到了Transaction这一层，需要在Include之后链式指定要加载的二级导航：

User user = dbcontext.Set<User>()
    .Include(u => u.Transactions)
        // 对查出的每个Transaction实体，继续加载它关联的Patient对象
        .ThenInclude(t => t.Patient)
    .FirstOrDefault(u => u.UserId == userId);

调整后，查出的每个Transaction条目都会附带对应的Patient实体，不会再出现null的情况。

避坑提示 #

不要为了图方便开启EF Core懒加载来解决这类导航为空的问题。懒加载会在你第一次访问导航属性时自动触发数据库查询，很容易产生大量不可控的循环SQL，造成严重的性能损耗，生产环境优先采用显式Include的方式加载明确需要的导航数据。

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