Spring JPA分页返回错误结果：首页总条数异常问题排查

你遇到的问题是因为Spring Data JPA默认生成的关联查询会产生笛卡尔积，导致count统计的是符合条件的Offer记录数，而非Store实体的数量。同时Spring Data JPA会对返回的Store结果进行去重，所以首页返回的实体是去重后的Store，但totalElements却沿用了关联查询的行数（也就是6条符合条件的Offer）。后续页面查询时，可能因去重后无数据触发了正确的count逻辑，或是缓存差异，但核心问题还是默认查询的count统计逻辑错误。

你需要修改Repository方法，确保查询和count统计都针对Store实体的唯一数量，有两种常用方式：

方式1：使用distinct查询 #

手动编写查询语句，指定返回distinct的Store，并配套正确的count查询：

@Repository
public interface StoreRepository extends JpaRepository<StoreEntity, Long> {

    @Query(value = "select distinct s from StoreEntity s join s.offers o where o.validTo > ?1",
           countQuery = "select count(distinct s.id) from StoreEntity s join s.offers o where o.validTo > ?1")
    Page<StoreEntity> findStoresWithActiveOffers(Instant validToGreaterThan, Pageable pageable);
}

• select distinct s 确保返回的Store实体不重复
• countQuery 明确统计distinct的Store ID数量，避免笛卡尔积导致的错误计数

方式2：使用exists子查询 #

通过exists子查询判断Store是否存在符合条件的Offer，这种方式天然避免笛卡尔积，count统计更高效准确：

@Repository
public interface StoreRepository extends JpaRepository<StoreEntity, Long> {

    @Query("select s from StoreEntity s where exists (select o from s.offers o where o.validTo > ?1)")
    Page<StoreEntity> findStoresWithActiveOffers(Instant validToGreaterThan, Pageable pageable);
}

这种方式的count查询会自动生成count(s)，统计存在符合条件Offer的Store数量，完全匹配你的需求。

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