Spring与Hibernate多表关联查询：单查询获取懒加载关联数据方案

当然可以！完全不用改动实体的懒加载配置，我们有两种非常实用的方式来一次性拉取所有需要的数据，彻底解决N+1查询的性能问题：

方法一：使用实体图（Entity Graph） #

实体图是JPA 2.1引入的特性，可以在查询时灵活指定要加载的关联实体，完美适配你这种链式关联的场景。

步骤1：在Root实体上定义命名实体图 #

@Entity
@NamedEntityGraph(
    name = "Root.withFullChain",
    attributeNodes = {
        // 指定加载foo，并关联子图加载bar
        @NamedAttributeNode(value = "foo", subgraph = "Foo.withBar")
    },
    subgraphs = {
        @NamedSubgraph(
            name = "Foo.withBar",
            attributeNodes = {
                // 指定加载bar，并关联子图加载qux
                @NamedAttributeNode(value = "bar", subgraph = "Bar.withQux")
            }
        ),
        @NamedSubgraph(
            name = "Bar.withQux",
            attributeNodes = {
                // 指定加载qux
                @NamedAttributeNode("qux")
            }
        )
    }
)
public class Root { 
    @Id
    private Long id;
    private String rootData; 
    @OneToOne(fetch = FetchType.LAZY) 
    private Foo foo; 
    // getter、setter省略
}

步骤2：在Repository中使用该实体图 #

public interface RootRepository extends JpaRepository<Root, Long> {
    // 通过EntityGraph指定要使用的加载策略
    @EntityGraph(value = "Root.withFullChain", type = EntityGraph.EntityGraphType.FETCH)
    List<Root> findAll();

    // 如果数据量太大，建议分页查询避免内存溢出
    @EntityGraph(value = "Root.withFullChain", type = EntityGraph.EntityGraphType.FETCH)
    Page<Root> findAll(Pageable pageable);
}

这样执行查询时，JPA会自动生成包含所有关联表的连接查询，一次性把Root、Foo、Bar、Qux的所有需要的数据加载进来，不会触发任何懒加载的额外查询。

方法二：自定义JPQL的JOIN FETCH查询 #

如果你更喜欢手动控制SQL逻辑，可以直接写带有JOIN FETCH的JPQL查询，强制一次性加载关联实体。

public interface RootRepository extends JpaRepository<Root, Long> {
    // 用JOIN FETCH链式加载所有关联实体
    @Query("SELECT r FROM Root r " +
           "JOIN FETCH r.foo f " +
           "JOIN FETCH f.bar b " +
           "JOIN FETCH b.qux q")
    List<Root> findAllWithFullChain();

    // 可选：如果存在关联为null的情况，用LEFT JOIN FETCH避免过滤掉数据
    @Query("SELECT r FROM Root r " +
           "LEFT JOIN FETCH r.foo f " +
           "LEFT JOIN FETCH f.bar b " +
           "LEFT JOIN FETCH b.qux q")
    List<Root> findAllWithFullChainOptional();

    // 分页版本
    @Query("SELECT r FROM Root r " +
           "JOIN FETCH r.foo f " +
           "JOIN FETCH f.bar b " +
           "JOIN FETCH b.qux q")
    Page<Root> findAllWithFullChain(Pageable pageable);
}

这里的关键是JOIN FETCH（或LEFT JOIN FETCH），它和普通的JOIN不同，会把关联实体的数据直接加载到查询结果的Root对象中，而不是仅做关联查询却不加载实体。

两种方法的对比 #

• 实体图：更灵活，适合复用相同的加载策略，尤其是关联链复杂时，不需要重复写JPQL；
• JPQL JOIN FETCH：更直观，适合需要添加自定义查询条件（比如过滤rootData）的场景。

两种方法都完全保留了实体原本的懒加载配置，只有在执行这些特定查询时才会一次性加载所有关联数据，完美适配你的报表生成需求。

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