Spring Data JPA中@EntityGraph引发多余关联查询的解决办法

1. 自定义JPQL查询，合并过滤与关联加载 #

直接编写JPQL查询，同时完成B的属性过滤和A关联B集合的预加载，避免Spring Data自动生成重复关联。示例代码：

@Repository
public interface ARepository extends JpaRepository<A, Long> {
    @Query("SELECT DISTINCT a FROM A a JOIN FETCH a.bList b WHERE b.x = :x")
    List<A> findAllByBx(@Param("x") String x);
}

这里用JOIN FETCH同时实现关联过滤与集合加载，DISTINCT用于消除因JOIN产生的A实体重复（一个A对应多个B时，JOIN会生成多行，DISTINCT能让Hibernate合并为唯一的A实例）。最终生成的SQL只会包含一次B表的JOIN，同时解决N+1查询和重复关联问题。

2. 结合@EntityGraph与@Query统一关联逻辑 #

若不想完全手写JPQL，可通过@Query定义过滤规则，搭配@EntityGraph指定关联加载，但需保证Query中的关联与EntityGraph的关联逻辑一致：

@Repository
public interface ARepository extends JpaRepository<A, Long> {
    @Query("SELECT a FROM A a JOIN a.bList b WHERE b.x = :x")
    @EntityGraph(attributePaths = "bList")
    List<A> findAllByBx(@Param("x") String x);
}

注意：部分版本的Hibernate仍可能生成重复JOIN，因此更推荐第一种JOIN FETCH的方式。

3. 调整实体关联的全局Fetch策略（谨慎使用） #

在A实体的bList属性上设置FetchMode.JOIN，将关联加载设为全局默认策略。但此方式会影响所有查询A的操作，若其他场景无需加载B集合，可能导致性能下降：

@Entity
public class A {
    // 其他属性
    @OneToMany(mappedBy = "a")
    @Fetch(FetchMode.JOIN)
    private List<B> bList;
}

之后仓库方法findAllByBx(String x)无需额外添加@EntityGraph，Spring Data生成的查询会自动JOIN B表一次，同时加载集合，解决N+1和重复JOIN问题。

4. 使用Subselect Fetch模式 #

若不想用JOIN，可采用FetchMode.SUBSELECT，Hibernate会先查询符合条件的A列表，再通过子查询一次性加载所有关联的B集合，仅生成2次查询（1次查A，1次查关联B），也不会出现重复JOIN：

@Entity
public class A {
    // 其他属性
    @OneToMany(mappedBy = "a")
    @Fetch(FetchMode.SUBSELECT)
    private List<B> bList;
}

仓库方法直接使用findAllByBx(String x)即可，无需添加@EntityGraph，既避免N+1问题，也不会产生重复关联语句。

内容的提问来源于stack exchange，提问作者Baptiste C.