如何避免Hibernate增强实体出现LazyInitializationException

针对你遇到的Hibernate字节码增强导致原有Jackson懒加载序列化方案失效的问题，这里提供几个实用的解决方向：

• 升级Jackson Hibernate兼容模块
  原有的jackson-datatype-hibernate5仅适配传统Hibernate Proxy懒加载模式，对字节码增强后的LazyAttributeLoadingInterceptor支持不足。可以替换为适配字节码增强的版本，比如jackson-datatype-hibernate5-jakarta（Jakarta EE环境），这类模块能识别增强后的懒加载字段标记，自动跳过未加载的字段序列化。

• 自定义Jackson序列化拦截逻辑
  自己实现序列化器修饰器，手动判断懒加载字段是否已初始化：

  1. 编写BeanSerializerModifier子类，过滤未初始化的懒加载字段：

  import com.fasterxml.jackson.databind.BeanDescription;
  import com.fasterxml.jackson.databind.SerializationConfig;
  import com.fasterxml.jackson.databind.ser.BeanSerializerModifier;
  import org.hibernate.proxy.LazyPropertyInitializer;
  import java.util.ArrayList;
  import java.util.List;
  
  public class HibernateEnhancedLazySerializerModifier extends BeanSerializerModifier {
      @Override
      public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) {
          List<BeanPropertyWriter> filteredProperties = new ArrayList<>();
          for (BeanPropertyWriter writer : beanProperties) {
              // 检查字段是否为懒加载且未初始化
              try {
                  Object fieldValue = writer.get(null);
                  if (!LazyPropertyInitializer.isLazyPropertyInitialized(writer.getMember().getAnnotated(), fieldValue)) {
                      continue;
                  }
              } catch (Exception e) {
                  // 处理字段获取异常，默认保留字段
              }
              filteredProperties.add(writer);
          }
          return filteredProperties;
      }
  }
  

  2. 将这个修饰器注册到ObjectMapper：

  ObjectMapper objectMapper = new ObjectMapper();
  objectMapper.registerModule(new SimpleModule() {
      @Override
      public void setupModule(SetupContext context) {
          super.setupModule(context);
          context.addBeanSerializerModifier(new HibernateEnhancedLazySerializerModifier());
      }
  });
  

• 实体类层面显式控制序列化
  若不想修改全局序列化配置，可在实体类的懒加载字段上添加Jackson注解：

  • 使用@JsonInclude(JsonInclude.Include.NON_INITIALIZED)（Jackson 2.12+支持），该注解会跳过未初始化的懒加载字段
  • 若确定不需要序列化某些懒加载字段，直接添加@JsonIgnore注解

• 调整Hibernate增强插件配置
  如果业务允许，可修改hibernate-enhanced-plugin的配置，让特定字段回归传统代理懒加载模式。例如在字段上添加@LazyToOne(LazyToOneOption.PROXY)，这样原有的jackson-datatype-hibernate5就能继续处理这些字段的序列化。

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