Spring Data Hibernate：自定义查询如何使用实体指定的FetchType？

问题场景 #

我正在开发基于Spring Boot 3.x、Spring Data和Hibernate 6.x的应用，现有如下User实体：

@Entity
public class User {

    @Id
    private UUID id = UUID.randomUUID();

    @Column
    private String country;

    @ManyToMany(fetch = FetchType.EAGER)
    private Set<Role> roles;

    // constructors, getters, setters, equals/hashcode based on id
}

当在仓库中执行如下自定义查询时：

@Query("""
   FROM User user
   WHERE user.country = ?1
""")
public Set<User> getUserByCountry(String country);

返回的Set<User>中roles属性被Hibernate懒加载，从SQL日志可看到每个用户对应一条roles查询。

我记得FetchType.EAGER曾因影响所有查询且无法取消而不被推荐，但当前情况与之矛盾：即使标注EAGER仍会懒加载。Hibernate最新大版本是否修改了该行为？能否让Hibernate对所有自定义查询默认按实体注解获取EAGER关联？

我尝试用@EntityGraph显式指定查询时预加载roles，效果良好，但更希望Hibernate在未添加@EntityGraph时自动从实体注解推断该配置。

补充：已验证Spring Boot 2.x+Hibernate 5.x中的获取行为不同，这似乎是Hibernate 6.x的特性。

解答 #

行为变更说明 #

Hibernate 6.x确实调整了FetchType.EAGER的处理逻辑，核心目的是优化查询性能，避免旧版本中EAGER关联强制全局加载带来的性能浪费。

在Hibernate 6.x中：

• 仅当使用默认查询方法（如Spring Data JPA的findById、findAll）或无关联指定的JPQL查询（如select u from User u）时，才会严格遵循实体上标注的FetchType.EAGER配置。
• 对于自定义JPQL/HQL查询（即@Query中指定的带条件或自定义关联的语句），Hibernate默认会忽略实体的FetchType.EAGER，默认采用懒加载策略，除非显式指定加载方式。

实现自定义查询默认遵循EAGER的方案 #

方案1：在JPQL中显式使用JOIN FETCH

直接修改自定义查询语句，通过JOIN FETCH强制预加载关联集合：

@Query("""
   FROM User user
   JOIN FETCH user.roles
   WHERE user.country = ?1
""")
public Set<User> getUserByCountry(String country);

这种方式精准控制单查询的加载策略，避免全局配置可能带来的副作用。

方案2：全局配置Hibernate参数

在application.properties或application.yml中添加全局配置，让Hibernate处理自定义JPQL时默认遵循实体的FetchType配置：

spring.jpa.properties.hibernate.query.default_fetch_lazy=false

该配置会让所有自定义JPQL查询默认使用实体标注的加载策略——EAGER关联自动预加载，LAZY关联保持懒加载。注意此配置是全局生效的，需评估是否符合整体系统的性能需求。

内容的提问来源于stack exchange，提问作者Martin Häusler