Hibernate 5升级后Criteria API出现N+1查询性能问题求助

我之前把Hibernate升级到5.x的时候，也踩过一模一样的N+1查询的坑，结合你的场景，给你几个实用的解决思路：

核心原因 #

Hibernate 5.x里，旧的Hibernate Criteria API（org.hibernate.Criteria）被标记为废弃，官方推荐使用JPA标准的Criteria API（javax.persistence.criteria.CriteriaQuery）。而两者对FetchType.EAGER关联的处理逻辑完全不同：

• Hibernate 4的旧Criteria会自动将EAGER关联转换成Fetch Join，生成单条带JOIN的SQL一次性拉取所有数据
• JPA Criteria（Hibernate 5默认推荐）不会自动处理EAGER关联的JOIN，哪怕实体标注了FetchType.EAGER，也会单独发起SQL查询关联数据，直接导致N+1问题

解决方案 #

1. 显式添加Fetch Join（最直接有效） #

在JPA Criteria查询中，手动指定要fetch的关联关系，强制生成JOIN语句：

// 获取CriteriaBuilder和CriteriaQuery实例
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<YourEntity> cq = cb.createQuery(YourEntity.class);
Root<YourEntity> root = cq.from(YourEntity.class);

// 关键：显式fetch关联的location，替换成你实际的关联属性名
// 关联类型选INNER或LEFT，根据业务需求决定
root.fetch("location", JoinType.INNER);

// 后续添加查询条件、排序等逻辑
cq.select(root).where(cb.equal(root.get("id"), 1L));

// 执行查询
List<YourEntity> result = entityManager.createQuery(cq).getResultList();

添加这条fetch语句后，Hibernate会生成包含JOIN的单条SQL，一次性拉取主实体和location的数据，彻底解决N+1。

2. 检查实体关联的注解配置 #

如果你的实体关联上还加了@Fetch(FetchMode.SELECT)或者@Fetch(FetchMode.SUBSELECT)，会覆盖FetchType.EAGER的默认行为，强制生成单独查询。可以暂时注释掉这类注解，测试是否解决问题。

3. （不推荐）继续使用旧Hibernate Criteria API #

如果暂时不想切换到JPA Criteria，也可以继续用旧API，但要注意它在Hibernate 5.x中已被标记为废弃，后续版本会移除：

Session session = entityManager.unwrap(Session.class);
Criteria criteria = session.createCriteria(YourEntity.class);
// 旧API会自动处理EAGER关联的JOIN，和Hibernate 4行为一致
criteria.add(Restrictions.eq("id", 1L));
List<YourEntity> result = criteria.list();

排查验证 #

开启Hibernate的SQL日志（配置hibernate.show_sql=true，或者通过日志框架打印org.hibernate.SQL的DEBUG日志），对比修改前后生成的SQL语句：

• 修改前：会看到1条查询主实体的SQL + N条查询location的SQL
• 修改后：只会看到1条包含JOIN的SQL

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