Spring Data JPA OneToOne映射懒加载时子实体仍被查询问题

DevOps 小满

2026-9-2

问题根因

你的配置存在三个核心问题导致懒加载失效：

实体类被final修饰：Hibernate默认的懒加载实现基于动态代理，需要生成实体类的子类完成拦截逻辑，final类无法被继承，根本无法生成代理对象，懒加载自然不生效。
外键持有方的OneToOne关联默认不支持普通代理懒加载：你的配置中A表是外键持有方（id列既是主键也是指向B表主键的外键），且@JoinColumn配置了nullable = false，等价于关联非可选。这种场景下Hibernate加载A时，必须判断关联对象是否存在才能确定字段赋值为null还是代理，而判断存在性必须查询B表，因此会直接触发关联查询，不会走懒加载。
Repository泛型配置错误：JpaRepository<A, Long>声明的主键类型为Long，和A实体实际的Integer类型主键不匹配，虽然不直接导致懒加载失效，但会引发运行时类型转换异常。

修复步骤

第一步：移除A、B两个实体类的final修饰符，保证Hibernate可以正常生成代理对象。
第二步：修正Repository接口的泛型声明，将主键类型改为Integer：

@Repository
public interface ARepository extends JpaRepository<A, Integer> {
  Optional<A> findById(Integer id);
}

第三步：针对外键持有方的OneToOne懒加载需求，开启Hibernate无代理懒加载能力：
1. 在A实体的b字段关联上添加Hibernate提供的@LazyToOne(LazyToOneOption.NO_PROXY)注解，声明使用字段级拦截的懒加载模式，不需要依赖子类代理判断关联存在性。
2. （双向关联场景可选配置）在B实体中添加对A的反向关联，通过mappedBy声明A为关联维护方：

@Entity
@Table(name = "b")
@Getter
@Setter
@NoArgsConstructor
public class B {

  @Id
  private Integer id;

  @Column(name = "test_column")
  private String testColumn;

  @OneToOne(mappedBy = "b", fetch = FetchType.LAZY)
  private A a;
  
}

修正后的A实体代码如下：

@Entity
@Table(name = "a")
@Getter
@Setter
@NoArgsConstructor
@Slf4j
public class A {

  @Id 
  private Integer id; 

  @OneToOne(fetch = FetchType.LAZY, optional = false)
  @MapsId
  @JoinColumn(name = "id", nullable = false)
  @LazyToOne(LazyToOneOption.NO_PROXY)
  private B b;
  
}

第四步：配置Hibernate字节码增强插件，在编译期为实体类注入懒加载拦截逻辑。以Maven为例，在pom.xml中添加如下插件配置，版本号和项目引入的Hibernate版本保持一致（Spring Boot 2.6.7默认对应Hibernate 5.6.x系列）：

<plugin>
  <groupId>org.hibernate.orm.tooling</groupId>
  <artifactId>hibernate-enhance-maven-plugin</artifactId>
  <version>5.6.8</version>
  <executions>
    <execution>
      <configuration>
        <enableLazyInitialization>true</enableLazyInitialization>
      </configuration>
      <goals>
        <goal>enhance</goal>
      </goals>
    </execution>
  </executions>
</plugin>

完成以上配置后，查询A实体时只会发起查询A表的SQL，只有实际调用getB()方法时才会触发B表的查询，达到懒加载预期。

注意：如果不配置字节码增强，仅添加@LazyToOne注解不会生效，外键持有方的OneToOne懒加载必须依赖字节码增强的字段拦截能力。

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