JPA如何结合Specification与Pageable实现关联关系eager加载分页查询

这个报错是Hibernate的保护机制触发的：你在使用left join fetch加载多对多集合kinds的同时做分页，Hibernate无法直接在SQL层面执行正确的分页逻辑——因为fetch join会返回Product和Kind的笛卡尔积结果集，直接加limit/offset是对笛卡尔积分页，而非对独立的Product实体分页。
默认情况下Hibernate会查询所有符合条件的结果，在内存中完成分页，数据量稍大就会严重损耗性能。你开启了Fail on pagination over collection fetch配置后，Hibernate会直接抛出错误阻止这种高风险操作。

方案1：两次查询法（兼容性最好，全版本适用） #

先分页查询符合条件的Product主键，再根据主键批量查询带关联关系的Product，既保证SQL层面的分页性能，又能实现eager加载关联集合。

步骤1：Repository层新增两个查询方法 #

// 仅分页查询符合条件的Product主键，无关联查询，分页性能最优
@Query("select p.id from Product p")
Page<Long> findAllIds(Specification<Product> spec, Pageable pageable);

// 根据主键批量查询，同时eager加载kinds关联
@Query("select distinct p from Product p left join fetch p.kinds where p.id in :ids")
List<Product> findAllByIdsWithEagerKinds(Collection<Long> ids);

步骤2：业务层组装逻辑 #

@Transactional(readOnly = true)
public Page<Product> findByCriteriaWithEagerKinds(ProductCriteria criteria, Pageable page) {
    log.debug("find by criteria with eager kinds : {}, page: {}", criteria, page);
    final Specification<Product> specification = createSpecification(criteria);
    // 第一步：分页查询符合条件的产品ID
    Page<Long> idPage = productRepository.findAllIds(specification, page);
    if (idPage.isEmpty()) {
        return Page.empty(page);
    }
    // 第二步：根据ID查询带kind关联的产品
    List<Product> products = productRepository.findAllByIdsWithEagerKinds(idPage.getContent());
    // 保留原分页信息返回
    return new PageImpl<>(products, page, idPage.getTotalElements());
}

方案2：@EntityGraph注解（适用Spring Data JPA 3.1+/Hibernate 6+） #

高版本Spring Data JPA搭配Hibernate 6+已经优化了关联加载的分页逻辑，直接使用@EntityGraph指定要加载的关联字段即可，无需手动拆分查询：

@EntityGraph(attributePaths = "kinds", type = EntityGraph.EntityGraphType.LOAD)
Page<Product> findAll(Specification<Product> spec, Pageable pageable);

Hibernate会自动先分页查询符合条件的Product主表数据，再批量查询关联的Kind集合，不会触发内存分页。

如果只是小数据量场景，可以临时关闭报错开关，让Hibernate继续走内存分页逻辑，生产环境大数据量不建议使用：
在application.yml中添加配置：

spring:
  jpa:
    properties:
      hibernate:
        hql:
          fail_on_pagination_over_collection_fetch: false

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