Spring Boot+Hibernate+Jackson懒加载序列化异常求助

你遇到的LazyInitializationException是Hibernate懒加载机制的典型问题——当Session已经关闭后，尝试访问未初始化的懒加载集合就会触发这个异常。你尝试的Hibernate5Module强制懒加载方案没生效，可能是因为模块没正确注册，或者Session在序列化前就已经关闭了。下面给你几个其他可行的解决思路：

1. 启用Open Session in View模式（OSIV） #

这个模式会把Session的生命周期延长到视图渲染完成，也就是Jackson序列化完成之后。在Spring MVC中可以通过两种方式配置：

方式一：添加拦截器到WebConfig #

@EnableWebMvc
@Configuration
@ComponentScan("...")
public class WebConfig implements WebMvcConfigurer {
    // 注入EntityManagerFactory
    @Autowired
    private EntityManagerFactory entityManagerFactory;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        OpenSessionInViewInterceptor interceptor = new OpenSessionInViewInterceptor();
        interceptor.setEntityManagerFactory(entityManagerFactory);
        registry.addInterceptor(interceptor);
    }

    // 你的其他消息转换器配置...
}

方式二：注册Servlet过滤器（如果是Servlet环境） #

在web.xml中添加：

<filter>
    <filter-name>openSessionInViewFilter</filter-name>
    <filter-class>org.springframework.orm.hibernate5.support.OpenSessionInViewFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>openSessionInViewFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

⚠️ 注意：OSIV模式可能会延长Session持有时间，带来潜在的性能和事务问题，需要根据你的业务场景评估。

2. 在业务层主动初始化懒加载集合 #

不要等到Jackson序列化时才加载集合，而是在Service层（此时Session还处于打开状态）主动初始化：

方式一：使用Hibernate.initialize() #

@Service
public class PropertyService {
    @Autowired
    private PropertyRepository propertyRepository;

    public Property getPropertyById(Long id) {
        Property property = propertyRepository.findById(id).orElse(null);
        // 主动初始化懒加载集合
        if (property != null) {
            Hibernate.initialize(property.getPropertyAttribute());
        }
        return property;
    }
}

方式二：使用Fetch Join查询 #

在Repository层通过JPQL或者Criteria查询时，直接关联加载懒加载集合：

@Repository
public interface PropertyRepository extends JpaRepository<Property, Long> {
    @Query("SELECT p FROM Property p JOIN FETCH p.propertyAttribute WHERE p.id = :id")
    Property findByIdWithAttributes(@Param("id") Long id);
}

这种方式更高效，因为它通过一次SQL查询就加载了主实体和关联集合，避免了N+1查询问题。

3. 检查Hibernate5Module是否正确生效 #

你配置的Hibernate5Module可能因为ObjectMapper被其他配置覆盖而没生效。可以尝试调整配置方式，确保模块被正确安装：

@Bean
public Hibernate5Module hibernate5Module() {
    Hibernate5Module module = new Hibernate5Module();
    module.disable(Feature.USE_TRANSIENT_ANNOTATION);
    module.enable(Feature.FORCE_LAZY_LOADING);
    return module;
}

@Bean
@Primary
public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter(Hibernate5Module hibernate5Module) {
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
    ObjectMapper objectMapper = Jackson2ObjectMapperBuilder.json()
            .modules(hibernate5Module)
            .build();
    converter.setObjectMapper(objectMapper);
    return converter;
}

另外，确保configureMessageConverters方法中没有重复添加转换器或者覆盖ObjectMapper的情况。

4. 使用DTO（数据传输对象）隔离实体与视图 #

创建专门的DTO类，在业务层将实体的属性（包括懒加载集合）复制到DTO中，然后返回DTO给前端：

// DTO类
public class PropertyDTO {
    private Long id;
    private String name;
    private List<PropertyAttributeDTO> propertyAttributes;

    // 构造器、getter、setter
}

// Service层转换
@Service
public class PropertyService {
    @Autowired
    private PropertyRepository propertyRepository;

    public PropertyDTO getPropertyDTOById(Long id) {
        Property property = propertyRepository.findByIdWithAttributes(id); // 使用fetch join查询
        PropertyDTO dto = new PropertyDTO();
        dto.setId(property.getId());
        dto.setName(property.getName());
        // 转换集合
        List<PropertyAttributeDTO> attributeDTOs = property.getPropertyAttribute().stream()
                .map(attr -> {
                    PropertyAttributeDTO attrDto = new PropertyAttributeDTO();
                    attrDto.setId(attr.getId());
                    attrDto.setValue(attr.getValue());
                    return attrDto;
                })
                .collect(Collectors.toList());
        dto.setPropertyAttributes(attributeDTOs);
        return dto;
    }
}

这种方式完全避免了懒加载问题，因为序列化的是DTO而不是Hibernate代理对象，同时也能更好地控制返回给前端的数据结构，符合分层架构的设计思想。

5. 临时调整实体的懒加载策略（不推荐长期使用） #

如果以上方案都暂时无法适配，可以临时把集合的fetch类型改为EAGER：

@Entity
public class Property {
    // 其他属性...
    @OneToMany(fetch = FetchType.EAGER, mappedBy = "property")
    private List<PropertyAttribute> propertyAttribute;
}

⚠️ 注意：这种方式会导致每次查询Property都会加载集合，可能带来严重的性能问题，尤其是当集合数据量大的时候，只建议作为临时应急方案。

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