配置Hibernate5模块后Jackson序列化遇懒加载初始化异常

问题场景 #

在大型Spring Boot应用中，实体类采用Hibernate懒加载关联（FetchType.LAZY），仅在数据库事务内加载所需子元素，避免立即加载或spring.jpa.open-in-view=true带来的性能问题。但序列化包含孙级懒加载集合的实体时，抛出懒加载初始化异常，期望将未初始化的懒加载属性/集合序列化为null，引入Jackson Hibernate5模块后问题仍未解决。

实体类示例：

@Entity 
public class Parent {
 
    @ManyToMany(fetch = FetchType.LAZY)
    @JsonManagedReference 
    private List<Child> children; 

}

@Entity 
public class Child {

    @ManyToMany(fetch = FetchType.LAZY)
    @JsonBackReference
    private List<Parent> parent;
 
    @OneToMany(fetch = FetchType.LAZY) 
    @JsonManagedReference
    private List<Grandchild> grandChildren; 

}

依赖版本 #

• Spring Boot 2.6.6
• Hibernate 5.6.7.Final
• Jackson 2.13.2
• Jackson Datatype Hibernate5 2.13.2

抛出异常 #

com.fasterxml.jackson.databind.JsonMappingException: failed to lazily initialize a collection of role: domain.Child.grandchildren, could not initialize proxy - no Session (through reference chain: java.util.ArrayList[0]->domain.Parent["children"]->org.hibernate.collection.internal.PersistentBag[0]->domain.Child["grandChildren"])

配置无效的原因分析 #

1. Jackson Hibernate5模块未正确注册：Spring Boot自动配置可能未将模块注入到ObjectMapper，导致Jackson未启用懒加载属性的特殊处理逻辑。
2. @JsonManagedReference/@JsonBackReference与模块冲突：这组注解会强制Jackson遍历双向关联关系，即使关联集合处于未初始化的懒加载状态，绕过Hibernate模块的懒加载判断，触发初始化操作进而抛出异常。
3. 模块配置参数不正确：未启用正确特性，导致未初始化的懒加载集合未被序列化为null。

解决方法 #

1. 确保Hibernate5模块正确注册 #

方式一：手动配置Bean

创建Jackson配置类，显式注册Hibernate5模块并配置特性：

@Configuration
public class JacksonHibernateConfig {
    @Bean
    public Module hibernate5Module() {
        Hibernate5Module module = new Hibernate5Module();
        // 禁用懒加载属性的自动加载，未初始化的属性序列化为null
        module.configure(Hibernate5Module.Feature.LAZY_LOADING_ENABLED, false);
        // 不序列化懒加载对象的ID，直接输出null
        module.configure(Hibernate5Module.Feature.SERIALIZE_IDENTIFIER_FOR_LAZY_NOT_LOADED_OBJECTS, false);
        // 允许序列化null值
        module.setSerializeNulls(true);
        return module;
    }
}

方式二：通过配置文件启用

在application.properties中添加配置，让Spring Boot自动注册模块：

spring.jackson.modules=com.fasterxml.jackson.datatype.hibernate5.Hibernate5Module

2. 替换双向关联注解，避免冲突 #

移除@JsonManagedReference和@JsonBackReference，改用@JsonIgnoreProperties处理双向关联，既避免循环引用，又不干扰Hibernate模块的懒加载处理：

@Entity 
public class Parent {
    @ManyToMany(fetch = FetchType.LAZY)
    @JsonIgnoreProperties("parent")
    private List<Child> children; 
}

@Entity 
public class Child {
    @ManyToMany(fetch = FetchType.LAZY)
    @JsonIgnoreProperties("children")
    private List<Parent> parent;
 
    @OneToMany(fetch = FetchType.LAZY) 
    @JsonIgnoreProperties("child") // 对应Grandchild类中的Child关联属性
    private List<Grandchild> grandChildren; 
}

3. 验证事务内加载逻辑 #

确保在数据库事务内仅加载业务所需的关联集合，未加载的懒加载集合在事务外序列化时，由Hibernate模块自动处理为null，避免事务内意外触发懒加载初始化。

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