Spring分页查询含懒加载关联属性的实体时初始化失败如何解决

问题根因 #

懒加载异常的核心原因是Repository层findAllAppUserWithAllProperties方法的JPQL语句使用错误：

• 你写的是LEFT JOIN u.appRoles，普通关联只会做表关联查询，不会将关联的appRoles集合数据加载到AppUser实体属性中，该集合仍然是未初始化的懒加载代理对象
• Repository方法执行完成后Session就会关闭，后续Controller层将实体序列化为JSON时，读取代理对象会触发无Session的懒加载异常，哪怕SQL日志中显示已经关联了角色表也不会生效。

修复方案 #

方案1：直接修正JPQL（小数据量场景首选） #

在关联语句中增加FETCH关键字，同时指定独立的count查询语句适配分页：

@Query(value = "SELECT u FROM AppUser u LEFT JOIN FETCH u.appRoles",
        countQuery = "SELECT count(u) FROM AppUser u")
Page<AppUser> findAllAppUserWithAllProperties(Pageable pageable);

注意：JOIN FETCH搭配分页时，Hibernate会先查询全量符合条件的用户数据，在内存中完成分页，用户表数据量小于10万的场景可以直接使用，无感知性能问题。

方案2：大数据量场景优化 #

如果用户表数据量很大，避免内存分页损耗性能可以采用两次查询方案：

• 先分页查询符合条件的用户ID列表
• 用IN查询搭配JOIN FETCH加载这批用户的全量属性
• 手动组装分页结果返回即可

方案3：无需返回角色时的简化处理 #

如果接口不需要返回用户角色信息，可以直接在appRoles属性上添加@JsonIgnore注解，序列化时会跳过该属性，也不会触发懒加载异常。

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