使用JPA获取实体及关联实体时遭遇LazyInitializationException异常

以下是针对该问题的具体排查和解决步骤：

• 确认@ManyToOne的FetchType配置
  虽然@ManyToOne默认FetchType为EAGER，但排查代码中是否不小心显式设置为LAZY。正确配置示例：

  @ManyToOne(fetch = FetchType.EAGER)
  @JoinColumn(name = "department_id")
  private Departments department;
  

• 确保事务覆盖关联实体的访问逻辑
  Service层的@Transactional如果仅到返回主实体为止，后续在Controller或DTO转换阶段访问关联实体时，事务已关闭，就会触发异常。解决方案是把关联实体的访问/转换逻辑放到事务内：

  @Service
  public class UserService {
      @Transactional
      public UserDTO getUserDTO(Long id) {
          User user = userRepository.findById(id).orElse(null);
          if (user == null) return null;
          UserDTO dto = new UserDTO();
          dto.setId(user.getId());
          // 在事务内访问关联实体，避免后续加载失败
          dto.setDepartmentName(user.getDepartment().getName());
          return dto;
      }
  }
  

• 处理Hibernate代理对象的初始化问题
  异常提示无法评估代理类的toString()，通常是在日志打印或调试时直接调用了未初始化的关联实体toString()。可以通过以下方式解决：

  • 在事务内提前触发关联实体的初始化（比如调用任意非getClass()的方法）
  • 使用Hibernate.initialize()强制初始化：

    @Transactional
    public User getUser(Long id) {
        User user = userRepository.findById(id).orElse(null);
        if (user != null) {
            Hibernate.initialize(user.getDepartment());
        }
        return user;
    }
    

  • 修改关联实体的toString()方法，避免访问未初始化的关联属性

• 检查自定义Repository查询是否包含fetch join
  若使用自定义JPQL查询，即使FetchType为EAGER，未添加fetch join会导致关联数据未被加载。修改查询示例：

  @Query("SELECT u FROM User u JOIN FETCH u.department WHERE u.id = :id")
  User findByIdWithDepartment(@Param("id") Long id);
  

• 验证事务管理器配置
  确认Spring事务管理器已正确关联到对应的EntityManagerFactory，确保@Transactional注解能真正开启事务。

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