使用@Query注解时QueryDsl Predicate被忽略的问题排查与解决

你遇到的这个情况既不是QueryDSL的Bug，也不是特性限制——问题出在**@Query注解的优先级逻辑**上：当你在findAll(Predicate, Pageable)方法上添加@Query时，Spring Data JPA会直接使用你定义的JPQL语句，完全跳过QueryDSL自动将Predicate转换为查询条件的流程，导致传入的搜索Predicate根本没被整合到最终SQL里，这就是搜索功能失效的核心原因。

要同时实现数据级权限控制和QueryDSL的搜索功能，这里有两种贴合你场景的解决方案：

方案一：手动合并权限Predicate与搜索Predicate（推荐） #

既然已经基于QueryDSL开发，我们可以直接用QueryDSL的API构建权限过滤条件，再和传入的搜索Predicate合并，完全不需要依赖@Query注解。

修改你的ProjectRepository的findAll实现：

import org.springframework.security.core.context.SecurityContextHolder;

@Override
@NonNull
default Page<Project> findAll(@NonNull Predicate predicate, @NonNull Pageable pageable) {
    // 构建当前用户的权限过滤Predicate：只返回该用户关联角色所属的项目
    QProject project = QProject.project;
    Predicate userFilter = project.roles.any().account.username.eq(
        SecurityContextHolder.getContext().getAuthentication().getName()
    );

    // 合并搜索条件和权限条件：如果有搜索Predicate就叠加，没有就只用权限过滤
    Predicate finalPredicate = predicate != null 
        ? new com.querydsl.core.BooleanBuilder().and(predicate).and(userFilter)
        : userFilter;

    // 调用父类的默认实现执行合并后的查询
    return QuerydslPredicateExecutor.super.findAll(finalPredicate, pageable);
}

这个方案完全贴合QueryDSL的使用逻辑，同时能保留你原来customize方法对字符串模糊匹配的配置，搜索功能会正常工作。

方案二：使用@Query配合SpEL动态拼接条件（可选） #

如果你更倾向于保留@Query的写法，可以通过SpEL表达式将QueryDSL的Predicate转换为JPQL条件拼接进去，但这种方式对Spring Data版本有要求，且可读性稍弱：

@Override
@Query("select p from Project p left join p.roles r left join r.account a " +
       "where ?#{principal.username} = a.username " +
       "and #{#predicate}")
@NonNull
Page<Project> findAll(@NonNull Predicate predicate, @NonNull Pageable pageable);

另外要注意：你接口上的@PreAuthorize是角色级的权限控制，和我们这里做的数据级权限过滤是互补的，两者可以同时保留，确保只有合法用户能访问接口，且只能看到自己有权限的项目。

内容的提问来源于stack exchange，提问作者Sebastiaan van den Broek