Spring Data JPA/Hibernate为何不绑定Pageable参数到生成查询？

环境与代码实现 #

使用spring-data-jpa (2.1.7.RELEASE)搭配Hibernate (5.6.9.Final)作为ORM实现，服务层创建Pageable对象传入仓库层：

服务层代码 #

Pageable pg = PageRequest.of(4, 2);
Page<Tuple> packagesList = packageRepository.getPackageByAccountIdAndPackageId(accountId, packageId, pg);   

仓库层代码 #

public interface PackageRepository extends JpaRepository<Packages, PackageId> {
    // ... 其他方法

    @Query(value = "SELECT p.package_id FROM packages p WHERE p.account_id=:accountId AND (CASE WHEN :packageId IS NULL THEN TRUE WHEN  p.package_id LIKE :packageId THEN TRUE ELSE FALSE END)",
            countQuery = "SELECT count(*) FROM packages", nativeQuery = true)
    Page<Tuple> getPackageByAccountIdAndPackageId(String accountId, String packageId, Pageable pg);
}

问题现象 #

生成的SQL中添加了limit约束，但TRACE日志未输出offset和limit对应的绑定参数：

Hibernate: 
    SELECT
        p.package_id 
    FROM
        packages p 
    WHERE
        p.account_id=? 
        AND (
            CASE 
                WHEN ? IS NULL THEN TRUE 
                WHEN  p.package_id LIKE ? THEN TRUE 
                ELSE FALSE 
            END
        ) limit ?, ?
2022-10-15 18:43:46.285 TRACE 68021 --- [nio-8095-exec-1] o.h.type.descriptor.sql.BasicBinder      : binding parameter [1] as [VARCHAR] - [40955353-d2c3-4377-8c95-6b403b7570ef]
2022-10-15 18:43:46.286 TRACE 68021 --- [nio-8095-exec-1] o.h.type.descriptor.sql.BasicBinder      : binding parameter [2] as [VARCHAR] - [%2]
2022-10-15 18:43:46.286 TRACE 68021 --- [nio-8095-exec-1] o.h.type.descriptor.sql.BasicBinder      : binding parameter [3] as [VARCHAR] - [%2]
2022-10-15 18:43:46.328 TRACE 68021 --- [nio-8095-exec-1] .s.t.s.TransactionSynchronizationManager : Retrieved value [org.springframework.orm.jpa.EntityManagerHolder@41baa13] for key [org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean@7317fb] bound to thread [http-nio-8095-exec-1]
2022-10-15 18:43:46.329 TRACE 68021 --- [nio-8095-exec-1] .s.t.s.TransactionSynchronizationManager : Retrieved value [org.springframework.orm.jpa.EntityManagerHolder@41baa13] for key [org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean@7317fb] bound to thread [http-nio-8095-exec-1]

问题解答 #

问题1：为何查询所需的offset和limit对应的绑定参数4、5未生成？ #

这是Hibernate日志输出的特性导致的：

• 在你使用的Hibernate 5.6.9.Final版本中，分页参数（limit/offset）的绑定逻辑不会通过BasicBinder的TRACE日志输出，而是由Hibernate内部的分页处理模块直接绑定到JDBC语句中，所以看不到对应的绑定记录。
• 你提到查询执行成功无异常，这足以证明分页参数已经被正确传递并生效——如果参数未绑定，数据库会直接抛出语法错误。

问题2：使用Pageable时countQuery是否为必填项？ #

不是必填项，但需分场景判断：

• JPQL查询场景：Spring Data JPA会自动根据主查询的逻辑生成对应的count查询，无需手动指定countQuery。
• 原生SQL查询场景（nativeQuery=true）：Spring Data JPA无法自动解析复杂的原生SQL来生成正确的count查询（不同数据库的原生语法差异较大），如果不指定countQuery，它会尝试自动修改主查询生成count语句，但大概率会失败（比如主查询包含子查询、分组、排序等逻辑时）。因此建议显式指定countQuery，确保分页的总条数统计准确。你示例中故意设置错误的countQuery，只会影响总条数的统计，不会干扰分页查询本身的执行。

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