使用JPA/Hibernate查询投影时如何跳过二级关联实体加载

API 探路者

2026-9-1

问题场景

现有三层一对一关联的JPA实体模型，需求为查询顶层实体的投影列表，投影仅需包含中层实体的部分属性，不需要加载底层实体。
相关代码定义如下：

@Entity
class TopLevelEntity {

    @EmbeddedId
    private TopLevelEntityId id;

    @OneToOne(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    @JoinColumn(name = "mid_level_entity_id")
    private MidLevelEntity midLevelEntity;

    @Column(name = "some_number")
    private Integer someNumber;

}

@Entity
class MidLevelEntity {

    @EmbeddedId
    private MidLevelEntityId id;

    @OneToOne(mappedBy = "midLevelEntity", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private BottomLevelEntity bottomLevelEntity; // 注：原代码此处字段类型笔误写为ID类，实际应为实体类型

}

@Entity
class BottomLevelEntity {

    @EmbeddedId
    private BottomLevelEntityId id;

    @OneToOne
    @JoinColumn(name = "mid_level_entity_id")
    private MidLevelEntity midLevelEntity; // 注：原代码此处字段类型笔误写为ID类，实际应为实体类型

}

interface TopLevelEntityProjection {

    TopLevelEntityId getTopLevelEntityId();

    @Value("#{target.midLevelEntity?.id}")
    MidLevelEntityId getMidLevelEntityId();

}

@Repository
public interface TopLevelEntityRepository extends JpaRepository<TopLevelEntity, TopLevelEntityId> {

    @EntityGraph(attributePaths = {"midLevelEntity.id"}, type = EntityGraph.EntityGraphType.FETCH)
    @Query("select e from TopLevelEntity e where e.someNumber > :someNumber")
    Page<TopLevelEntityProjection> findTopLevelEntitiesWithSomeNumberGreaterThanSomeOtherNumber(Integer someNumber, Pageable pageable);

}

异常表现

执行查询方法时，生成的第一条SQL可正常查询顶层与中层实体的所需数据
后续会针对每一条返回结果，额外触发底层实体的查询语句：即使投影逻辑完全未使用底层实体，这些实体仍会被懒加载
简化复现：直接查询MidLevelEntity时也存在相同现象，即使投影未使用BottomLevelEntity，后者仍会被懒加载
已排除equals/hashCode方法触发关联访问的可能：重写两个方法并添加断点调试后，确认查询过程中并未调用这两个方法
需求目标：不将底层实体关联改为急加载，实现完全跳过底层实体加载的效果

根因说明

该问题是Hibernate对双向@OneToOne关联的默认处理机制导致的：
代码中MidLevelEntity是双向一对一关联的被维护端（关联配置了mappedBy = "midLevelEntity"，外键存储在BottomLevelEntity表中），Hibernate加载MidLevelEntity的托管实例时，无法从当前实体自身的字段判断bottomLevelEntity关联是null还是存在对应实体，必须额外查询一次BottomLevelEntity表确认关联是否存在，才能给该属性赋值（要么为null，要么生成代理对象）。这个检查逻辑是实体加载流程的内置环节，和投影是否访问该属性无关，因此会产生额外的N+1查询。

可行解决方案

以下方案均可实现完全跳过底层实体加载的效果，无需将关联改为急加载：

方案1：显式指定投影字段，避免加载完整中层实体
改写JPQL语句，直接查询投影需要的字段，通过别名匹配投影接口的方法，不加载MidLevelEntity的完整托管实例，从根源上避免触发关联存在性检查。示例代码如下：
```
@Repository
public interface TopLevelEntityRepository extends JpaRepository<TopLevelEntity, TopLevelEntityId> {
    @Query("select e.id as topLevelEntityId, e.midLevelEntity.id as midLevelEntityId " +
           "from TopLevelEntity e where e.someNumber > :someNumber")
    Page<TopLevelEntityProjection> findTopLevelEntitiesWithSomeNumberGreaterThanSomeOtherNumber(Integer someNumber, Pageable pageable);
}
```
该方案无需额外配置，生成的SQL只会查询顶层实体ID、中层实体ID两个字段，完全不会访问底层实体对应的表，是侵入性最低、性能最好的方案。
方案2：配置字节码增强实现真正的懒加载
给MidLevelEntity中的底层实体关联添加@LazyToOne(LazyToOneOption.NO_PROXY)注解，同时开启Hibernate字节码增强（可通过hibernate-enhance-maven-plugin插件配置，开启enableLazyInitialization配置项）。
配置后Hibernate不需要在加载中层实体时就检查关联是否存在，只有代码真正访问bottomLevelEntity属性时才会触发查询，完全符合懒加载的预期。
方案3：移除不需要的双向关联
如果业务逻辑中不需要从中层实体直接访问底层实体，可以直接删除MidLevelEntity中定义的bottomLevelEntity关联字段，仅保留BottomLevelEntity侧指向中层实体的关联即可。没有了被维护端的关联属性，自然不存在加载实体时的额外检查查询。

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