Hibernate 5结合Lombok时实体类出现LazyInitializationException问题

这个问题我之前碰到过好几次，核心矛盾点在于Lombok生成的默认Getter和Hibernate懒加载的代理逻辑不兼容，才会抛出org.hibernate.LazyInitializationException: could not initialize proxy - no Session异常。

问题根源 #

• Hibernate的懒加载实体其实是动态代理对象，它的初始化逻辑是通过拦截方法调用来触发的——当你调用实体的getter方法时，代理会检查Session是否存在，如果存在就初始化关联数据。
• 但Lombok默认生成的@Getter是直接访问类的成员字段（比如return this.orders;），这种直接访问会绕过Hibernate代理的方法拦截逻辑。当Session已经关闭时，自然就无法初始化懒加载的关联数据，抛出异常。

可行的解决方案 #

1. 给Lombok的@Getter添加lazy=true参数

这是最直接的适配方式，Lombok的@Getter(lazy=true)会生成一个特殊的Getter，内部通过Supplier来处理字段访问，同时确保方法调用能被Hibernate代理拦截到。

示例代码：

import lombok.Getter;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.OneToMany;
import java.util.ArrayList;
import java.util.List;

@Entity
public class User {
    @Id
    private Long id;

    @OneToMany(fetch = FetchType.LAZY)
    @Getter(lazy = true) // 关键配置
    private List<Order> orders = new ArrayList<>();

    // 其他字段、Setter或构造方法
}

2. 在Session/事务范围内初始化懒加载属性

如果不想修改Lombok的注解，那就要确保在Session还没关闭的时候，就把需要的懒加载数据初始化完成。有两种常见方式：

• 用Hibernate.initialize()手动触发初始化：

  // 在事务方法内执行
  User user = userRepository.findById(userId).orElseThrow();
  Hibernate.initialize(user.getOrders()); // 提前加载关联数据
  

• 在JPQL/HQL查询中使用JOIN FETCH，一次性获取主实体和关联数据：

  String jpql = "SELECT u FROM User u JOIN FETCH u.orders WHERE u.id = :userId";
  User user = entityManager.createQuery(jpql, User.class)
                          .setParameter("userId", userId)
                          .getSingleResult();
  

3. 全局配置Lombok的访问方式

在项目根目录下创建lombok.config文件，添加以下配置，让Lombok生成的Getter/Setter都通过方法调用的逻辑（本质还是访问字段，但能被代理拦截）：

lombok.accessors.field = false

注意：这是全局配置，会影响所有使用Lombok的类，需要确认项目中其他类是否适配这种方式。

4. 手动编写Getter方法

如果以上配置都不想用，最稳妥的方式就是手动编写Getter，确保是标准的方法调用形式，这样Hibernate代理就能正常拦截并初始化数据：

@Entity
public class User {
    @Id
    private Long id;

    @OneToMany(fetch = FetchType.LAZY)
    private List<Order> orders = new ArrayList<>();

    // 手动编写Getter
    public List<Order> getOrders() {
        return orders;
    }
}

总结 #

优先推荐第一种@Getter(lazy=true)的方式，它既保留了Lombok的便捷性，又完美适配Hibernate的懒加载机制；如果项目对Lombok的全局配置有要求，或者需要更灵活的初始化控制，第二种在Session内初始化的方式也非常实用。

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