使用@Fetch(FetchMode.JOIN)仍遇JpaRepository的N+1查询问题

问题根源 #

Spring Data JPA的分页查询（Pageable）会忽略Hibernate的@Fetch(FetchMode.JOIN)注解。原因是分页需要先执行count查询获取总条数，而JOIN关联查询会返回重复的主表数据，导致count结果不准确。因此Spring Data JPA默认会先查询分页后的主表数据，再逐条查询关联的Student数据，最终触发N+1查询。

另外你的实体类存在一个问题：@OneToMany关联缺少@JoinColumn配置，默认会生成中间表，不仅影响关联逻辑，也会干扰JOIN查询的执行。

解决方案 #

步骤1：修正实体类关联配置 #

在University的@OneToMany注解中添加@JoinColumn，明确指定外键关系，避免生成不必要的中间表：

public class University {
    @Id
    private String id;
    private String name;
    private String address;
    @ToString.Exclude
    @OneToMany
    @JoinColumn(name = "university_id") // 指定Student表中的外键字段
    private Set<Student> students = new HashSet<>();
}

步骤2：自定义JPQL查询实现JOIN FETCH #

在UniversityRepository中添加自定义查询方法，通过显式的LEFT JOIN FETCH实现关联查询，同时用DISTINCT去重主表数据：

public interface UniversityRepository extends JpaRepository<University, String> {
    @Query("SELECT DISTINCT u FROM University u LEFT JOIN FETCH u.students")
    Page<University> findAllWithStudents(Pageable pageable);
}

步骤3：配置JPA属性适配分页与去重 #

在application.properties中添加以下配置，确保count查询结果正确，同时允许DISTINCT去重：

spring.jpa.properties.hibernate.query.distinct_root_entity=true
spring.data.jpa.repository.query.use-distinct-with-count=false

• hibernate.query.distinct_root_entity=true：让Hibernate识别DISTINCT是针对主实体去重
• use-distinct-with-count=false：让count查询不使用DISTINCT，避免统计重复数据导致的总条数错误

步骤4：修改测试代码使用自定义查询 #

将测试类中的findAll替换为自定义的findAllWithStudents方法：

@Test
public void findAll() {
    List<University> universityList = repository.findAllWithStudents(new PageRequest(0, 100)).getContent();
    for (University university : universityList) {
        log.info("{} [{}]", university.getName(), university.getAddress());
        for (Student student : university.getStudents()) {
            log.info("{}, {}", student.getLastName(), student.getFirstName());
        }
    }
}

效果验证 #

修改后，执行测试只会生成两条SQL：

1. 一条count查询统计University的总条数
2. 一条包含LEFT JOIN的查询，一次性获取所有分页的University及其关联的Student数据

彻底解决N+1问题，同时满足分页需求。

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