使用LEFT JOIN FETCH仍遇Spring JPA多对多N+1查询问题

核心原因 #

你遇到的额外N+1查询，不是来自User的roles关联，而是来自Role实体中反向关联的users集合。

从SQL日志可以看到，额外执行的SQL都是查询users_roles和users表，条件是role_id——这是因为Hibernate加载完User关联的Role对象后，你的代码后续触发了Role的users集合的懒加载（比如序列化到JSON、日志打印时输出该集合、业务逻辑中遍历该集合等）。

Role类中定义的@ManyToMany(mappedBy = "roles") private Set<User> users是双向多对多的反向端，默认采用懒加载策略。当这个集合被访问时，Hibernate会为每个Role单独执行一次查询，获取对应的用户列表，从而产生N+1问题。

解决方案 #

针对这个问题，你可以根据业务需求选择以下方案：

• 避免访问Role的users集合：检查业务代码、序列化配置或日志逻辑，确认是否有不必要的操作触发了对Role的users集合的访问。如果业务不需要从Role端查看关联用户，直接避免访问该字段即可。
• 删除或显式配置懒加载：如果永远不需要从Role端关联查询用户，直接删除Role类中的users字段；如果保留该字段，显式声明fetch = FetchType.LAZY（默认就是懒加载，显式声明更清晰），避免意外触发加载。
• 阻止序列化触发懒加载：如果是JSON序列化（比如返回给前端时）导致的问题，在Role的users字段上添加@JsonIgnore注解，阻止序列化框架访问该集合。
• 按需抓取（不推荐）：如果确实需要从Role端获取用户，且要避免N+1，可以在User的查询中嵌套抓取Role的users，但这会导致笛卡尔积，数据量较大时性能反而下降，仅在必要时使用。

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