Spring Data JPA仓库使用PageRequest测试报错求助

问题原因 #

你定义的findAllByPriceBetween方法，Spring Data JPA会根据方法名自动生成SQL查询，该方法名对应的逻辑仅需要from和to两个价格参数。但你额外传入了PageRequest作为第三个参数，JPA会将其视为普通查询参数，然而自动生成的SQL中并没有对应的占位符，最终导致参数数量不匹配，抛出异常。

Spring Data JPA对Pageable/Sort类型的参数有特殊处理逻辑，只有遵循规范使用时，才会将其用于构建分页、排序条件，而非当作普通查询参数。

解决办法 #

提供两种可行的修复方案：

方案一：调整方法返回值为分页类型，规范参数顺序 #

修改ProductRepository的方法定义，将返回值改为Page<Product>，并确保Pageable作为最后一个参数：

@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
    Page<Product> findAllByPriceBetween(BigDecimal from, BigDecimal to, Pageable pageable);
}

然后在测试代码中调整结果接收逻辑：

Page<Product> productPage = productRepository.findAllByPriceBetween(BigDecimal.valueOf(1200),
        BigDecimal.valueOf(Integer.MAX_VALUE), pageRequest);
List<Product> actual = productPage.getContent();

这种方式下，Spring Data JPA会自动识别Pageable参数，生成包含分页和排序逻辑的SQL。

方案二：使用@Query自定义查询 #

如果需要保持返回值为List<Product>，可以通过@Query自定义查询，显式指定参数，并让JPA识别分页参数：

@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
    @Query("SELECT p FROM Product p WHERE p.price BETWEEN :from AND :to")
    List<Product> findProductsByPriceRange(@Param("from") BigDecimal from, @Param("to") BigDecimal to, Pageable pageable);
}

此时JPA会自动将最后一个Pageable参数用于构建分页和排序条件，不会将其当作普通查询参数处理。

补充提示 #

• Spring Data JPA中，Pageable或Sort类型参数只有作为方法的最后一个参数时，才会被自动识别为分页/排序条件参数。
• 方法命名规则生成查询时，若参数中包含Pageable但未遵循位置规范，会被误判为普通查询参数，引发参数不匹配问题。

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