PageRequest结合JOIN FETCH分页Produto实体的问题及优化诉求

核心问题原因 #

使用JOIN FETCH加载一对多关联（Produto -> Variacao）时，SQL会返回重复的Produto行（每个Variacao对应一行），Hibernate为了得到唯一的Produto实体，必须先把所有符合条件的记录加载到内存中去重后再做分页，这就触发了HHH90003004警告（内存分页）。FetchType.EAGER本质和JOIN FETCH逻辑一致，所以也解决不了问题。

可行解决方案 #

1. 结合DISTINCT和PASS_DISTINCT_THROUGH查询提示 #

通过JPQL的distinct关键字配合Hibernate的查询提示，让数据库层面执行分页，Hibernate在内存中完成去重，既避免内存分页，又一次性加载关联实体。

示例代码：

String jpql = "select distinct p from Produto p " +
              "left join fetch p.variacoes " +
              "left join fetch p.franquia " +
              "where ..."; // 你的查询条件

Query query = entityManager.createQuery(jpql, Produto.class);
query.setHint(QueryHints.HINT_PASS_DISTINCT_THROUGH, false); // 关键：不让distinct传递到SQL
query.setFirstResult(page * pageSize);
query.setMaxResults(pageSize);

List<Produto> produtos = query.getResultList();

• 原理：SQL层面只执行LIMIT/OFFSET分页，不执行DISTINCT，Hibernate拿到分页后的结果集后，在内存中去重得到唯一的Produto实体，同时关联的Variacao和Franquia已被预加载，无N+1问题。
• 注意：如果关联的Variacao数量极大，返回的SQL结果行数会较多，但分页逻辑是数据库层面执行的，不会出现全表加载的情况。

2. 使用实体图（Entity Graph）配合DISTINCT #

实体图可以更灵活地指定要预加载的关联属性，配合distinct同样能解决问题：

首先定义实体图：

@NamedEntityGraph(
    name = "Produto.withVariacoesAndFranquia",
    attributeNodes = {
        @NamedAttributeNode("variacoes"),
        @NamedAttributeNode("franquia")
    }
)
@Entity
public class Produto {
    // 实体字段和关联定义
}

然后查询时使用：

String jpql = "select distinct p from Produto p where ...";

Query query = entityManager.createQuery(jpql, Produto.class);
query.setHint("javax.persistence.loadgraph", 
              entityManager.getEntityGraph("Produto.withVariacoesAndFranquia"));
query.setHint(QueryHints.HINT_PASS_DISTINCT_THROUGH, false);
query.setFirstResult(page * pageSize);
query.setMaxResults(pageSize);

List<Produto> produtos = query.getResultList();

• 优势：实体图可以复用，适合多场景的关联加载需求，代码更整洁。

3. 使用@BatchSize注解（轻量级替代方案） #

如果不想修改查询逻辑，可通过@BatchSize让Hibernate批量加载关联实体，将N+1查询优化为1+1查询，性能接近一次性加载：

在Produto的一对多关联上添加注解：

@OneToMany(mappedBy = "produto", fetch = FetchType.LAZY)
@BatchSize(size = 20) // 批量加载的数量，根据业务调整
private List<Variacao> variacoes;

在Franquia的多对一关联上也可添加：

@ManyToOne(fetch = FetchType.LAZY)
@BatchSize(size = 20)
private Franquia franquia;

• 原理：查询分页后的Produto列表后，Hibernate会自动执行一条IN语句，批量加载所有Produto对应的Variacao和Franquia，避免N+1问题。
• 优点：无需修改查询代码，仅需添加注解，实现成本极低；性能优于手动批量查询ID的方式，Hibernate自动处理关联加载。

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