如何避免Spring Boot API返回JSON对象出现循环嵌套问题

在Spring Boot中，实体类双向关联导致JSON序列化循环嵌套是常见问题，以下是几种实用的解决思路：

1. 用Jackson注解精准控制序列化 #

Jackson提供了专门处理双向关联的注解，能直接在实体类上调整序列化行为：

• @JsonIgnore：在其中一方的关联字段上添加该注解，序列化时会忽略这个字段，从根源切断循环。比如在Process类的users字段上标注，返回ApplicationUser时就不会嵌套Process里的用户列表。
• @JsonManagedReference + @JsonBackReference：这组注解是Jackson为双向关联设计的标准方案。@JsonManagedReference标注在主控方（比如ApplicationUser的processes字段），@JsonBackReference标注在从属方（Process的users字段）。序列化时，主控方的关联数据会正常输出，从属方的关联字段会被忽略，既保留必要关联又避免循环。
  代码示例：

  @Entity
  public class ApplicationUser {
      @Id
      private Long id;
      private String username;
  
      @ManyToMany
      @JsonManagedReference
      private List<Process> processes;
      // getter、setter
  }
  
  @Entity
  public class Process {
      @Id
      private Long id;
      private String name;
  
      @ManyToMany(mappedBy = "processes")
      @JsonBackReference
      private List<ApplicationUser> users;
      // getter、setter
  }
  

• @JsonIdentityInfo：如果需要保留双向关联的完整数据又不想循环，可以用该注解让Jackson在遇到重复对象时输出ID而非完整结构。比如在实体类上添加：

  @JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
  @Entity
  public class ApplicationUser {
      // ... 字段定义
  }
  

  这样同一个ApplicationUser对象再次出现时，会直接输出它的id，避免嵌套循环。

2. 使用DTO（数据传输对象）层 #

这是最推荐的方案，完全脱离实体类的关联限制，只返回前端需要的数据：

• 定义与前端需求匹配的DTO类，比如ApplicationUserDTO，只包含id、username、email等必要字段，或者只返回关联对象的ID列表而非完整实体。
• 用MapStruct、ModelMapper等工具简化实体到DTO的映射，减少手动代码量。
  代码示例：

  public class ApplicationUserDTO {
      private Long id;
      private String username;
      private List<Long> processIds; // 仅返回关联流程的ID，而非完整Process对象
  
      // 构造器、getter、setter
  }
  

  在Controller中，把ApplicationUser实体转换为ApplicationUserDTO后再返回，彻底避免关联字段的序列化问题。

3. 调整JPA的Fetch策略 #

通过懒加载避免不必要的关联数据加载：

• 将双向关联的FetchType设置为LAZY（默认就是LAZY，除非手动改成了EAGER），比如：

  @ManyToMany(fetch = FetchType.LAZY)
  private List<Process> processes;
  

  这样默认情况下不会加载关联对象，序列化时自然不会出现循环。但要注意：如果在事务外部访问懒加载字段，会抛出LazyInitializationException，所以要么保证序列化操作在事务内执行，要么通过@EntityGraph或Fetch Join主动加载需要的关联数据。

4. 全局配置Jackson序列化（不推荐） #

如果想快速临时解决，可在配置文件中禁用循环引用检测：

spring:
  jackson:
    serialization:
      fail-on-self-references: false

但这种方式比较粗暴，会影响所有实体的序列化行为，不如注解或DTO方案精准，仅适合临时调试场景。

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