Spring Boot使用@OneToMany关联表返回空列表问题求助

以下是几个实用的排查方向，你可以逐一验证：

• 验证数据库外键数据正确性
  先确认subcategory表的category_id字段值是否真的关联到category表中存在的id，有没有出现类型不匹配（比如存了字符串类型的id）或者值错误的情况。
  直接执行SQL查询验证：

  SELECT * FROM subcategory WHERE category_id = [某条category记录的id];
  

  如果这条SQL查不到数据，说明数据库里的关联关系本身就有问题，先修正数据。

• 检查实体类关联配置细节
  虽然你设置了FetchType.EAGER，但还是要确认几个配置点：

  • @OneToMany的mappedBy值必须和SubCategoryEntity中关联字段的名称完全一致（Java大小写敏感），你的代码里mappedBy="category"是正确的，因为SubCategoryEntity里的字段就是category；
  • 可以尝试给@OneToMany添加orphanRemoval = true，帮助维护关联关系的一致性；
  • 另外，@Data注解自动生成的equals和hashCode方法可能会因为关联实体导致循环引用问题，你可以手动生成这两个方法，生成时排除subcategories字段试试。

• 查看SQL执行日志，确认关联查询是否触发
  开启JPA的SQL日志，看Hibernate实际执行的SQL是否包含子分类表的关联查询：
  在application.properties中添加配置：

  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

  调用接口后，如果日志里的SQL没有LEFT JOIN subcategory的语句，说明关联查询没触发；如果有JOIN但返回空，那还是数据的问题。
  也可以在Repository中自定义强制关联查询的方法：

  @Repository
  public interface CategoryRepository extends JpaRepository<CategoryEntity, Long> {
      @Query("SELECT c FROM CategoryEntity c JOIN FETCH c.subcategories")
      List<CategoryEntity> findAllWithSubcategories();
  }
  

  然后在Controller中调用这个方法，看是否能返回子分类数据。

• 排查JSON序列化导致的空值问题
  如果数据库和查询都没问题，但返回前端时子分类为空，大概率是循环引用导致Jackson序列化时忽略了关联对象。
  可以在实体类中添加JSON注解解决：

  // CategoryEntity 中的关联字段
  @OneToMany(mappedBy = "category", fetch = FetchType.EAGER, cascade = CascadeType.ALL)
  @JsonManagedReference
  private Set<SubCategoryEntity> subcategories;
  
  // SubCategoryEntity 中的关联字段
  @ManyToOne
  @JoinColumn(name = "category_id")
  @JsonBackReference
  private CategoryEntity category;
  

  @JsonManagedReference和@JsonBackReference用来处理双向关联的循环序列化问题，确保子分类能正常被序列化返回。

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