EF Core自引用多对多关系无法正确加载子部件问题排查

以下是几个可能导致该问题的原因及对应的解决办法：

• 复合主键的自引用关系未正确配置
  EF需要明确的映射规则来识别复合主键下的自引用关联。如果没有在OnModelCreating中配置外键与主键的对应关系，框架无法自动关联父子部件。示例配置代码：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      // 配置复合主键
      modelBuilder.Entity<TraceablePart>()
          .HasKey(tp => new { tp.PartNumber, tp.Revision, tp.SerialNumber });
  
      // 配置一对多自引用：父部件拥有多个子部件，子部件对应单个父部件
      modelBuilder.Entity<TraceablePart>()
          .HasMany(tp => tp.ChildParts)
          .WithOne(tp => tp.ParentPart)
          .HasForeignKey(tp => new { tp.ParentPartNumber, tp.ParentRevision, tp.ParentSerialNumber })
          .OnDelete(DeleteBehavior.Restrict);
  }
  

  注意：实体类中必须包含单个ParentPart导航属性（而非仅ParentParts集合），因为每个子部件只能归属一个父部件，这是一对多关系的核心。如果你的实体只有ParentParts集合，EF无法识别关联方向。

• 未主动加载导航集合
  EF默认不会自动加载导航集合（延迟加载需要额外配置）。如果查询时没有显式指定加载ChildParts，集合会为空：

  • 显式贪婪加载示例：

    var targetPart = dbContext.TraceableParts
        .Include(tp => tp.ChildParts)
        .FirstOrDefault(tp => tp.PartNumber == 1234 && tp.Revision == 1 && tp.SerialNumber == 1);
    

  • 若要使用延迟加载，需满足：实体类为非密封的public类，导航属性标记为virtual，且在DbContext配置中启用代理（optionsBuilder.UseLazyLoadingProxies()）。

• 数据库外键数据不匹配
  检查子部件对应的外键字段（如ParentPartNumber、ParentRevision、ParentSerialNumber）是否完全匹配父部件的复合主键值(1234, 1, 1)。任何一个字段值不匹配，都会导致关联无法被识别。

• 实体类导航属性定义错误
  确保实体类的导航属性符合一对多自引用的结构：

  public class TraceablePart
  {
      public int PartNumber { get; set; }
      public int Revision { get; set; }
      public int SerialNumber { get; set; }
  
      // 单个父部件导航属性
      public TraceablePart ParentPart { get; set; }
      // 对应父部件的外键字段
      public int? ParentPartNumber { get; set; }
      public int? ParentRevision { get; set; }
      public int? ParentSerialNumber { get; set; }
  
      // 子部件集合
      public ICollection<TraceablePart> ChildParts { get; set; } = new List<TraceablePart>();
  }
  

  如果你的实体中仅定义了ParentParts集合而非单个ParentPart，这不符合一对多关系的逻辑，EF无法正确映射关联。

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