Spring Boot @OneToOne双向关联懒加载失效问题求助

你遇到的三次查询问题，本质是Hibernate对双向@OneToOne关联的默认行为导致FetchType.LAZY失效。即使你给RefreshToken和ForgotPassword的关联设置了懒加载，Hibernate仍会自动查询这两个关联表——因为@OneToOne是强一对一约束，Hibernate需要确认当前用户是否存在对应的关联实体，所以会触发额外的查询语句。

下面提供两种可行的解决方法，按推荐优先级排序：

方法一：使用@LazyToOne实现真正懒加载 #

通过@LazyToOne(LazyToOneOption.NO_PROXY)注解配合Hibernate字节码增强，让懒加载真正生效，避免不必要的关联查询。

步骤1：修改User实体 #

在两个@OneToOne字段上添加@LazyToOne注解：

public class User {
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Id
    private Long id;
    private String email;
    private String password;

    @OneToOne(mappedBy = "user", fetch = FetchType.LAZY)
    @LazyToOne(LazyToOneOption.NO_PROXY)
    private RefreshToken refreshToken;
    
    @Enumerated(EnumType.STRING)
    private Role role;

    @OneToOne(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
    @LazyToOne(LazyToOneOption.NO_PROXY)
    private ForgotPassword forgotPassword;

    // getter setters
}

步骤2：开启Hibernate字节码增强 #

在Spring Boot配置文件中添加以下配置：

• 如果是application.properties：

  spring.jpa.hibernate.use_bytecode_enhancement=true
  

• 如果是application.yml：

  spring:
    jpa:
      hibernate:
        use_bytecode_enhancement: true
  

方法二：投影查询（仅获取必要字段） #

如果当前业务场景只需要验证用户存在，不需要关联的RefreshToken和ForgotPassword数据，可以通过投影查询只获取User的核心字段，避免触发关联查询。

步骤1：定义投影接口 #

创建一个只包含需要字段的接口：

public interface UserProjection {
    Long getId();
    String getEmail();
}

步骤2：修改Repository方法 #

在UserRepository中添加投影查询方法：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    Optional<UserProjection> findByEmail(String email);
}

步骤3：修改Service逻辑 #

在generateAndStoreOtp方法中使用投影查询：

public long generateAndStoreOtp(String email) {
    UserProjection user = userRepository.findByEmail(email)
            .orElseThrow(() -> new UsernameNotFoundException("Please provide a valid email!"));

    int otp = otpGenerator(); 
    String redisKey = "otp:" + email; 
    redisTemplate.opsForValue().set(redisKey, otp, Duration.ofSeconds(70));

    return otp;
}

这样查询只会获取User的id和email，不会触发关联表的查询。

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