Spring双向关联配置FetchType.LAZY仍出现JSON无限循环如何解决？

成因 #

• JPA的FetchType.LAZY仅控制数据库查询时的加载时机，不影响JSON序列化逻辑。默认使用的Jackson序列化工具会递归调用所有Getter方法获取属性值：序列化User时会读取role属性得到Role对象，序列化Role时又会读取users属性得到关联的User集合，集合中的每个User会再次读取role属性，最终形成无限递归触发栈溢出。
• Lombok自动生成的@Getter注解为所有属性提供了公开的读取方法，给序列化工具的递归访问提供了入口，该问题和@Accessors注解无关。

可行解决方案 #

方案1：使用Jackson注解切断循环（快速修复） #

这是改动最小的实现方式，按需选择以下任意一种即可：

• 关联侧单侧加@JsonIgnore：在不需要序列化的关联属性上添加该注解，比如在Role类的users属性上加@JsonIgnore，序列化Role时会直接忽略该字段，直接切断递归链路。
• 配对使用@JsonManagedReference+@JsonBackReference：在@ManyToOne侧的role属性上加@JsonManagedReference（标注为主关联侧，正常序列化），在@OneToMany侧的users属性上加@JsonBackReference（标注为从关联侧，序列化时忽略），语义比直接加@JsonIgnore更清晰。
• 加@JsonIdentityInfo注解：给两个实体类都添加该注解，示例配置如下：

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class User { /* 类属性 */ }

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Role { /* 类属性 */ }

该方案会将已经序列化过的实体替换为对应的id值，既保留双向关联的关联标识，又不会出现重复序列化的问题，适合需要双向返回关联信息的场景。

方案2：使用DTO层解耦（最佳实践） #

单独定义适配接口输出的DTO类，只封装需要返回给前端的字段，查询到JPA实体后手动/借助工具拷贝属性到DTO再返回，完全避免将JPA实体直接暴露给序列化流程。该方案还能隔离实体类变更对接口输出的影响，是企业级开发的标准实现方式。

方案3：全局配置Jackson序列化规则（不推荐） #

在Spring配置文件中添加如下配置，关闭循环引用报错：

spring:
  jackson:
    serialization:
      FAIL_ON_SELF_REFERENCES: false

该配置为全局生效，会自动忽略所有循环引用返回null，可能隐藏实际业务问题，仅适合临时调试使用。

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