如何在Spring Boot的@Query中传入动态JPQL查询参数？

你之前的两种思路都不适用：@Query注解的查询语句是编译期固定的，无法直接传入完整的动态JPQL作为参数；启用nativeQuery=true后会把传入的语句当作原生SQL执行，自然不符合JPQL的需求。

正确的做法是通过EntityManager直接执行动态生成的JPQL，具体步骤如下：

1. 定义自定义Repository接口 #

先创建一个包含动态查询方法的自定义接口，和主Repository分离：

public interface JobCustomRepository {
    // 执行无参数的动态JPQL
    List<Job> findByDynamicJpql(String jpql);
    // 执行带参数的动态JPQL（更安全，避免注入）
    List<Job> findByDynamicJpqlWithParams(String jpql, Object... params);
}

2. 实现自定义Repository #

编写实现类，注入EntityManager来执行JPQL：

@Repository
public class JobCustomRepositoryImpl implements JobCustomRepository {

    private final EntityManager entityManager;

    // 构造方法注入EntityManager
    public JobCustomRepositoryImpl(EntityManager entityManager) {
        this.entityManager = entityManager;
    }

    @Override
    public List<Job> findByDynamicJpql(String jpql) {
        return entityManager.createQuery(jpql, Job.class)
                .getResultList();
    }

    @Override
    public List<Job> findByDynamicJpqlWithParams(String jpql, Object... params) {
        Query query = entityManager.createQuery(jpql, Job.class);
        // 绑定参数（JPQL的占位符从1开始计数）
        for (int i = 0; i < params.length; i++) {
            query.setParameter(i + 1, params[i]);
        }
        return query.getResultList();
    }
}

3. 让主Repository继承自定义接口 #

修改你的JobRepository，使其同时继承JpaRepository和自定义的JobCustomRepository：

public interface JobRepository extends JpaRepository<Job, Long>, JobCustomRepository {
    // 这里可以保留原有的Spring Data JPA默认方法
}

注意事项 #

• 确保动态生成的JPQL语法正确，否则会抛出查询语法异常；
• 尽量使用带参数的方法（findByDynamicJpqlWithParams），避免直接拼接参数到JPQL字符串中，防止JPQL注入风险；
• 如果需要分页查询，可以在方法中添加Pageable参数，调用query.setFirstResult和query.setMaxResults实现，或者直接链式调用entityManager.createQuery(jpql, Job.class).setFirstResult(...).setMaxResults(...)。

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