Spring Data JPA多对多关系中如何避免N+1查询问题？

核心原因分析 #

你的GroupEntity中@ManyToMany默认采用EAGER加载策略，即便添加了FetchType.LAZY和@JsonIgnore，如果在DTO转换或其他逻辑中不小心访问了clients集合，依然会触发懒加载查询，导致大量额外SQL生成。

具体解决方案 #

1. 显式设置懒加载并避免触发集合访问 #

首先在@ManyToMany注解上明确指定懒加载策略，同时检查DTO映射逻辑：

GroupEntity {
    @ManyToMany(fetch = FetchType.LAZY) // 必须显式声明LAZY，默认是EAGER
    @JoinTable(
            name = "rel_group_client",
            joinColumns = @JoinColumn(name = "group_id"),
            inverseJoinColumns = @JoinColumn(name = "client_id")
    )
    @Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
    @JsonIgnore
    private Set<ClientEntity> clients = new HashSet<>();
}

• 重点检查groupMapper.toDto方法：确保该方法没有调用getClients()、遍历clients集合，或是尝试将clients映射到DTO字段。只要不触发对clients的任何访问，懒加载就不会执行额外查询。

2. 自定义查询仅获取GroupEntity数据 #

如果业务不需要ClientEntity相关数据，可以在GroupRepository中定义专属查询，只查询GroupEntity自身字段：

public interface GroupRepository extends JpaRepository<GroupEntity, Long> {
    @Query("SELECT g FROM GroupEntity g")
    Page<GroupEntity> findAllWithoutClients(Pageable pageable);
}

然后在业务方法中替换原查询：

@Override
@Transactional(readOnly = true)
public Page<GroupDTO> findAll(Pageable pageable) {
    return groupRepository.findAllWithoutClients(pageable).map(groupMapper::toDto);
}

这种方式会生成仅查询group_entity表的SQL，完全不会涉及关联表和ClientEntity的查询操作。

3. 检查Hibernate懒加载配置（可选） #

如果上述方法无效，可添加配置禁止事务外的隐式懒加载触发：

spring.jpa.hibernate.enable_lazy_load_no_trans=false

注：你的方法已添加@Transactional(readOnly = true)，此配置为补充检查项，用于排除事务边界外的懒加载触发场景。

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