Spring Boot 3.x中带条件Left Join查询结果异常的解决诉求

Spring Boot 3.x（基于Hibernate 6.x）对EntityGraph与JPQL关联查询的交互逻辑做了调整：

• 在Spring Boot 2.6.x（Hibernate 5.x）中，JPQL里的关联过滤条件（left join r.attributes a on a.type = '2'）会被同步应用到EntityGraph的关联加载中，最终只加载符合条件的属性。
• 升级到Spring Boot 3.x后，EntityGraph的关联加载逻辑独立于JPQL，会忽略JPQL中的过滤条件，直接加载所有关联属性，导致返回结果包含了原本被过滤的type='2'的Attribute。

方案1：移除EntityGraph，改用JPQL JOIN FETCH控制关联加载 #

直接在JPQL中通过join fetch指定急加载关联，并保留过滤条件，让Hibernate生成符合预期的SQL，同时保持LEFT JOIN的语义。

修改后的Repository代码：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    @Query("""
        select user
        from User user
        left join fetch user.role r
        left join fetch r.attributes a on a.type <> '2'
        where user.id = :userId
    """)
    User getMyUser(@Param("userId") Long userId);
}

注：这里将条件改为a.type <> '2'，是为了匹配你在Spring Boot 2.6.4中得到的返回结果（排除type=2的Attribute），可根据实际业务需求调整。

方案2：使用Hibernate过滤器结合EntityGraph #

通过定义实体过滤器，让EntityGraph加载关联属性时自动应用过滤规则，确保只加载符合条件的Attribute。

步骤1：在Attribute实体上定义过滤器 #

@Entity
@FilterDef(name = "excludeAttributeType", parameters = @ParamDef(name = "excludedType", type = String.class))
@Filter(name = "excludeAttributeType", condition = "type <> :excludedType")
public class Attribute {
    @Id
    @GeneratedValue
    private Long id;
    @ManyToOne
    @JoinColumn(name = "role_id")
    private Role role;
    private String type;
    // getter/setter 省略
}

步骤2：在Repository方法中启用过滤器 #

@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    @Query("select user from User user where user.id = :userId")
    @EntityGraph("User.getRoles")
    @QueryHints({
        @QueryHint(name = org.hibernate.annotations.QueryHints.FILTERS_ENABLED, value = "true"),
        @QueryHint(name = "excludeAttributeType", value = ":excludedType")
    })
    User getMyUser(@Param("userId") Long userId, @Param("excludedType") String excludedType);
}

步骤3：调用时传入过滤参数 #

public User method() {
    var myUser = userRepository.getMyUser(1L, "2");
    System.out.println(myUser);
    return myUser;
}

方案3：动态EntityGraph结合过滤器（Hibernate 6+专属） #

通过动态构建EntityGraph，并手动启用过滤器，灵活控制关联加载的过滤规则：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    @Autowired
    EntityManager entityManager;

    default User getMyUser(Long userId) {
        // 构建动态EntityGraph
        EntityGraph<User> entityGraph = entityManager.createEntityGraph(User.class);
        entityGraph.addSubgraph("role").addSubgraph("attributes");
        
        // 启用过滤器
        Session session = entityManager.unwrap(Session.class);
        Filter filter = session.enableFilter("excludeAttributeType");
        filter.setParameter("excludedType", "2");
        
        try {
            return findById(userId).orElse(null);
        } finally {
            // 关闭过滤器，避免影响其他查询
            filter.disable();
        }
    }
}

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