Hibernate中FetchMode与JoinType的区别及关联查询多SQL问题排查

首先，我得先帮你理清FetchMode.Join和JoinType的核心区别，再拆解哪些场景会导致Criteria触发多条SQL查子实体——这两个问题其实是紧密关联的。

一、FetchMode.Join vs JoinType：完全不同的作用定位 #

1. JoinType：控制SQL层面的连接逻辑 #

JoinType（比如INNER_JOIN、LEFT_OUTER_JOIN）本质是用来定义数据库SQL语句中JOIN的类型，它决定的是两张表如何在数据库层面关联，以及最终返回的结果集包含哪些行：

• 用INNER_JOIN时，只有主实体和子实体匹配的行才会被返回；
• 用LEFT_OUTER_JOIN时，即使子实体没有匹配数据，主实体也会被保留在结果里。

但要注意：JoinType本身不控制Hibernate是否立即加载子实体。哪怕你用了INNER_JOIN，如果子实体的默认加载策略是懒加载（FetchType.LAZY），Hibernate只会先加载主实体，等你第一次访问子实体的时候，才会触发额外的SQL去查询——这就是你遇到“多条SQL”的常见原因之一。

2. FetchMode.Join：控制关联实体的加载策略 #

FetchMode.Join的作用是强制Hibernate通过单条SQL语句同时加载主实体和关联的子实体，它本质是把关联实体的加载策略从默认的懒加载改成“立即抓取”，并且用JOIN的方式实现。

简单总结：

• JoinType管的是「数据库怎么关联两张表」；
• FetchMode.Join管的是「Hibernate怎么加载关联实体（是否和主实体一次性查完）」。

你之前尝试了InnerJoin和FetchMode.Join但没生效？大概率是遇到了下面要讲的“触发多条SQL的场景”，比如分页操作。

二、Criteria查询触发多条SQL查子实体的常见场景 #

下面这些情况，哪怕你设置了FetchMode.Join，也可能会触发多条SQL：

• 默认懒加载未被覆盖：如果你的关联实体（比如子实体集合）在注解里设置了fetch = FetchType.LAZY（这是@OneToMany的默认值），且你没有通过setFetchMode("children", FetchMode.Join)显式覆盖，Hibernate会先加载主实体，等你访问子实体时再发SQL。
• 使用了分页（setFirstResult/setMaxResults）：这是最容易踩坑的点！Hibernate在处理分页时，为了避免JOIN后结果集行数翻倍（比如一个主实体对应3个子实体，SQL会返回3行）导致分页逻辑错误，会先执行一条SQL查询主实体的ID列表（分页后的），再执行另一条SQL根据ID批量查询子实体——这时候FetchMode.Join会被忽略，必然触发多条SQL。
• FetchMode设置错误：如果不小心把FetchMode设成了SELECT或SUBSELECT：
  • FetchMode.SELECT会对每个主实体单独发一条SQL查子实体（典型的N+1问题）；
  • FetchMode.SUBSELECT会用一条子查询一次性查所有子实体，但还是会产生两条SQL。
• Bag类型集合未配置合适的抓取策略：如果你的子实体集合是Bag（比如ArrayList，没有唯一约束的集合），且没有设置@Fetch(FetchMode.SUBSELECT)或FetchMode.Join，Hibernate默认会用懒加载，触发多条SQL。
• 使用了投影（Projection）或分组（Group By）：当你在Criteria中只查询部分字段（比如用setProjection），或者使用分组函数时，Hibernate不会自动抓取关联实体，需要显式设置抓取策略，否则会触发懒加载SQL。
• 二级缓存的影响：如果主实体存在于二级缓存中，但子实体不在，当你访问子实体时，Hibernate会触发SQL去加载子实体。

三、解决你当前问题的建议 #

如果想通过单条SQL加载父实体和所有子实体，确保满足以下条件：

1. 不要使用分页（setFirstResult/setMaxResults）；
2. 同时设置正确的JoinType和FetchMode.Join：

Criteria criteria = session.createCriteria(ParentEntity.class);
// 定义关联的Join类型，根据业务需求选择INNER_JOIN或LEFT_OUTER_JOIN
criteria.createAlias("children", "c", JoinType.INNER_JOIN);
// 强制用JOIN方式抓取子实体
criteria.setFetchMode("children", FetchMode.JOIN);
List<ParentEntity> parentList = criteria.list();

3. 确保你的集合注解没有设置fetch = FetchType.LAZY并覆盖Criteria的设置（其实setFetchMode会覆盖注解的加载策略，但最好统一检查）。

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