如何让JPA使用单次连接查询完成两侧实体条件过滤

实体定义 #

两个实体为一对多关联关系：单个Entity1可关联多个Entity2，单个Entity2仅归属一个Entity1，代码如下：

@Entity
@Table(name = "entity1")
public class Entity1 {

    int x;
    int y;
    ...
    @LazyCollection(LazyCollectionOption.TRUE)
    @OneToMany(mappedBy = "e1", cascade = CascadeType.ALL, orphanRemoval = true)
    private Set<Entity2> entity2s = new HashSet<>();

}


@Entity
@Table(name = "entity2")
public class Entity2 {

    int a;
    int b;  
    ...
    @ManyToOne
    @JoinColumn(name = "entity1_id")
    @JsonBackReference
    private Entity1 e1;

}

需求与现存问题 #

需要查询同时满足Entity2自身属性条件、关联Entity1属性条件的Entity2集合。

初始写法问题 #

初始查询直接在WHERE子句中通过隐式关联路径访问e2.e1的属性做过滤：

@Query("SELECT " +
       " e2 " +
       "FROM " +
       " Entity2 e2 " +
       "WHERE " +
       " e2.a = '<val1>' AND e2.b = '<val2>' AND e2.e1.x = '<val3>' AND e2.e1.y ='<val4>'")
List<Entity2> findMyEntity2s(
        @Param...,
        @Param...,
);

该写法会触发典型N+1查询问题：虽然SQL层面会通过两表交叉连接返回匹配的Entity2结果，但JPA不会自动把连接查询到的Entity1字段填充到关联属性中，会为结果集中每一条Entity2单独发起一次查询加载关联的e1对象，例如返回5条Entity2就会额外产生5次针对entity1表的查询。

已尝试方案的缺陷 #

• 配置@ManyToOne(fetch = FetchType.LAZY)：仅延迟关联对象加载时机，首次访问e1属性时依然会触发额外查询，无法从根本上消除N+1。
• 搭配@EntityGraph预加载关联：
  首先在Entity2上定义命名实体图：

  @Entity
  @Table(name = "entity2")
  @NamedEntityGraph(name = "graph.entity2.entity1",
      attributeNodes = { @NamedAttributeNode("e1") })
  public class Entity2 {
      // 实体属性省略，与之前定义一致
  }
  

  再在Repository方法上关联实体图，保留原WHERE隐式路径条件：

  @EntityGraph(value = "graph.entity2.entity1")
  @Query("SELECT " +
         " e2 " +
         "FROM " +
         " Entity2 e2 " +
         "WHERE " +
         " e2.a = '<val1>' AND e2.b = '<val2>' AND e2.e1.x = '<val3>' AND e2.e1.y ='<val4>'")
  List<Entity2> findMyEntity2s(
          @Param...,
          @Param...,
  );
  

  该方案解决了N+1问题，实体图会自动生成左连接同时查询两表字段填充关联属性，但WHERE子句中的隐式关联路径会让JPA额外生成一次不必要的entity1表交叉连接做条件校验，产生冗余查询。
• 移除关联属性条件、应用层二次过滤：

  @EntityGraph(value = "graph.entity2.entity1")
  @Query("SELECT " +
         " e2 " +
         "FROM " +
         " Entity2 e2 " +
         "WHERE " +
         " e2.a = '<val1>' AND e2.b = '<val2>'")
  List<Entity2> findMyEntity2s(
          @Param...,
          @Param...,
  );
  

  该写法仅在SQL层面过滤Entity2自身属性，查询完成后在内存中过滤关联Entity1的属性条件，会把大量不符合条件的记录加载到内存，浪费数据库与应用资源，不符合规范。
• 原生SQL查询：配置nativeQuery = true的原生查询不支持@EntityGraph，直接抛出异常；即使不使用实体图，结果映射时依然会根据外键触发关联e1的额外查询。

解决方案 #

方案1：JPQL 显式 JOIN FETCH（推荐，无额外配置） #

不需要依赖@EntityGraph，直接在JPQL中显式声明JOIN FETCH加载关联e1对象，WHERE条件直接使用显式关联的别名，全程仅执行一次内连接查询，同时完成条件过滤和关联对象填充，无冗余查询、无N+1：

@Query("SELECT e2 " +
       "FROM Entity2 e2 " +
       "JOIN FETCH e2.e1 e1 " +
       "WHERE e2.a = :val1 AND e2.b = :val2 AND e1.x = :val3 AND e1.y = :val4")
List<Entity2> findMyEntity2s(@Param("val1") int val1,
                             @Param("val2") int val2,
                             @Param("val3") int val3,
                             @Param("val4") int val4);

说明：

• 这里默认使用内连接，和原隐式路径生成的交叉连接语义完全一致，仅返回关联Entity1存在、且满足所有过滤条件的Entity2记录。
• FETCH关键字会告诉JPA直接将连接查询到的Entity1字段填充到e2.e1属性中，不会触发额外查询。
• 必须使用命名参数绑定查询条件，禁止直接拼接参数到SQL字符串，避免SQL注入风险；参数类型需与实体字段类型匹配，示例中字段为int类型因此参数用int，实际按字段类型调整即可。

方案2：@EntityGraph 配合显式JOIN（保留实体图配置场景） #

如果需要复用已定义的@EntityGraph规则，不需要加FETCH关键字，只需要在JPQL中显式声明JOIN并给关联起别名，WHERE条件使用别名过滤，即可避免隐式路径带来的冗余连接：

@EntityGraph(value = "graph.entity2.entity1", type = EntityGraph.EntityGraphType.LOAD)
@Query("SELECT e2 " +
       "FROM Entity2 e2 " +
       "JOIN e2.e1 e1 " +
       "WHERE e2.a = :val1 AND e2.b = :val2 AND e1.x = :val3 AND e1.y = :val4")
List<Entity2> findMyEntity2s(@Param("val1") int val1,
                             @Param("val2") int val2,
                             @Param("val3") int val3,
                             @Param("val4") int val4);

说明：显式指定实体图类型为LOAD，避免默认加载策略可能带来的非预期属性加载问题。

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