升级Hibernate至5.4.25启用LazyInitialization增强后遇AssertionError

问题根源 #

这个错误的核心是Hibernate 5的字节码增强机制对延迟加载集合的状态追踪逻辑和Hibernate 3的InstrumentTask存在差异：当你在事务外修改了未加载延迟集合的游离态实体，再带入新事务保存后访问该延迟集合时，Hibernate的状态校验逻辑会发现实体的修改状态与内部追踪的加载状态不一致，触发断言报错。

具体解决办法 #

• 最佳实践：避免事务外修改游离态实体
  Hibernate的实体状态管理依赖事务上下文，事务外修改游离态实体本身就容易引发状态不一致。调整代码流程：

  • 将实体修改逻辑移入事务内执行；
  • 若必须在事务外处理，修改后通过merge()方法将实体重新纳入新事务的持久化上下文，而非直接保存：

    // 新事务内执行
    OrderModel mergedOrder = entityManager.merge(orderModel);
    // 访问合并后的实体集合
    for (OrderPosition pos : mergedOrder.getOrderPositions()) {
        // 业务逻辑
    }
    

• 针对性修复：预加载目标集合
  在步骤2的预加载阶段，主动预加载orderPositions集合，从根源避免后续延迟加载触发状态校验：

  // 方式1：使用FetchGraph预加载
  OrderModel order = entityManager.find(OrderModel.class, orderId, 
      JoinFetchGraph.of(OrderModel_.orderPositions));
  
  // 方式2：JPQL Fetch Join查询
  String jpql = "select o from OrderModel o join fetch o.orderPositions where o.id = :id";
  OrderModel order = entityManager.createQuery(jpql, OrderModel.class)
      .setParameter("id", orderId)
      .getSingleResult();
  

• 临时过渡：调整字节码增强配置
  如果暂时无法修改业务流程，可以关闭脏状态追踪，回到类似Hibernate 3的行为（注意会失去脏追踪的性能优化）：

  <!-- Ant EnhancementTask配置示例 -->
  <taskdef name="enhance" classname="org.hibernate.tool.enhance.EnhancementTask">
      <classpath refid="project.classpath"/>
  </taskdef>
  <enhance base="${classes.dir}" enableLazyInitialization="true" enableDirtyTracking="false"/>
  

• 局部兼容：禁用单个实体的延迟加载增强
  若仅个别实体出现问题，可在实体类上注解禁用增强，退回到传统代理式延迟加载：

  @Entity
  @org.hibernate.annotations.Entity(disableLazyLoadingEnhancement = true)
  public class OrderModel {
      // 实体字段与方法
  }
  

总结 #

优先采用事务内修改+merge合并的最佳实践，对齐Hibernate 5的持久化规范；业务受限的情况下，优先用预加载方案针对性解决；调整增强配置或禁用增强仅作为临时过渡方案，长期建议逐步适配新版本的状态管理逻辑。

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