本文旨在解决Spring JPA实体间双向多对多关系在Jackson序列化时导致的无限递归（StackOverflowError）问题。我们将详细介绍如何利用Jackson的`@JsonManagedReference`和`@JsonBackReference`注解来管理对象图的序列化，并结合Lombok的`@EqualsAndHashCode`和`@ToString`注解进一步优化实体行为，确保在数据获取和序列化过程中避免循环引用，从而生成结构清晰、可读性强的JSON数据。
理解无限递归问题
在使用Spring Data JPA构建实体关系时，特别是双向的@ManyToMany关联，当尝试将这些实体通过Jackson库序列化为JSON时，很容易遇到“无限递归”（Infinite Recursion）错误，表现为StackOverflowError。
问题根源：以Project和Technology为例，它们之间存在一个双向的@ManyToMany关系：
Project实体中有一个Set assignedTechnologies。Technology实体中有一个Set projects。
当Jackson尝试序列化一个Project对象时，它会遍历assignedTechnologies集合，序列化其中的每个Technology对象。在序列化Technology对象时，Jackson又会发现其内部的projects集合，并尝试序列化其中的Project对象，如此往复，形成一个无限循环，最终导致栈溢出。
// 示例：Project实体片段public class Project { // ... @ManyToMany(mappedBy = "projects") private Set assignedTechnologies = new HashSet();}// 示例：Technology实体片段public class Technology { // ... @ManyToMany @JoinTable( name = "projects_technologies", joinColumns = @JoinColumn(name="technology_id"), inverseJoinColumns = @JoinColumn(name="project_id") ) private Set projects = new HashSet();}
当执行projectRepository.findAll()并尝试将其返回给API时，Jackson会触发上述循环，产生如下错误：
Could not write JSON: Infinite recursion (StackOverflowError); nested exception is com.fasterxml.jackson.databind.JsonMappingException: Infinite recursion (StackOverflowError) (through reference chain: java.util.ArrayList[0]->com.example.technologyradar.model.Project["assignedTechnologies"])]
核心解决方案：Jackson注解
解决Jackson序列化无限递归问题的最常用且推荐的方法是使用@JsonManagedReference和@JsonBackReference注解。这两个注解用于标记关系的两端，告诉Jackson在序列化时如何处理循环引用。
@JsonManagedReference (管理端): 标记关系中“拥有”或“管理”另一端引用的字段。当序列化时，此字段会被正常序列化。@JsonBackReference (回溯端): 标记关系中“被引用”的字段。当序列化时，此字段会被忽略，从而打破循环。
应用示例：在Project和Technology的@ManyToMany关系中，我们可以选择其中一端作为管理端，另一端作为回溯端。通常，我们会选择在序列化时希望看到完整信息的实体作为管理端。
修改后的Project实体：
package com.example.technologyradar.model;import com.fasterxml.jackson.annotation.JsonManagedReference; // 引入Jackson注解import lombok.AllArgsConstructor;import lombok.Data;import lombok.NoArgsConstructor;import org.hibernate.annotations.GenericGenerator;import javax.persistence.*;import java.util.HashSet;import java.util.Set;@Entity@Data@AllArgsConstructor@NoArgsConstructorpublic class Project { @Id @GeneratedValue(strategy = GenerationType.AUTO, generator = "native") @GenericGenerator(name="native", strategy = "native") private Long id; private String name; @ManyToMany(mappedBy = "projects") @JsonManagedReference // 标记为管理端，正常序列化Technology集合 private Set assignedTechnologies = new HashSet();}
修改后的Technology实体：
package com.example.technologyradar.model;import com.example.technologyradar.dto.constant.TechnologyStatus;import com.fasterxml.jackson.annotation.JsonBackReference; // 引入Jackson注解import lombok.AllArgsConstructor;import lombok.Data;import lombok.NoArgsConstructor;import org.hibernate.annotations.GenericGenerator;import javax.persistence.*;import java.util.HashSet;import java.util.Set;@Entity@Data@AllArgsConstructor@NoArgsConstructorpublic class Technology { @Id @GeneratedValue(strategy = GenerationType.AUTO, generator = "native") @GenericGenerator(name="native", strategy = "native") private Long id; private String name; @Enumerated(EnumType.STRING) private TechnologyStatus technologyStatus; @OneToOne(fetch = FetchType.EAGER, cascade = CascadeType.PERSIST, targetEntity = Category.class) @JoinColumn(name="category_id", referencedColumnName = "id", nullable = false) private Category category; @OneToOne(fetch = FetchType.EAGER, cascade = CascadeType.PERSIST, targetEntity = Coordinate.class) @JoinColumn(name="coordinate_id", referencedColumnName = "id", nullable = false) private Coordinate coordinate; @ManyToMany @JoinTable( name = "projects_technologies", joinColumns = @JoinColumn(name="technology_id"), inverseJoinColumns = @JoinColumn(name="project_id") ) @JsonBackReference // 标记为回溯端，在序列化Technology时忽略Project集合 private Set projects = new HashSet();}
通过上述修改，当序列化Project时，其assignedTechnologies会被完全序列化。当序列化assignedTechnologies中的Technology对象时，Technology内部的projects字段由于带有@JsonBackReference注解，将被Jackson忽略，从而有效避免了无限递归。
辅助优化：Lombok注解
除了Jackson的序列化注解，Lombok的@Data注解自动生成的equals()、hashCode()和toString()方法也可能在某些情况下（例如调试、日志输出或集合操作）导致类似的循环引用问题，即使不涉及JSON序列化。为了避免这种情况，我们可以对@Data注解进行精细控制。
Revid AI
AI短视频生成平台
96 查看详情
问题分析：@Data注解默认会为所有非静态字段生成equals()、hashCode()和toString()方法。如果这些方法在执行时递归地访问关联实体，同样会造成StackOverflowError。
解决方案：使用@EqualsAndHashCode(of = “id”)和@ToString(of = “id”)注解，将equals()、hashCode()和toString()方法的生成范围限制在实体的ID字段上。这样，这些方法在比较或打印对象时将不会遍历其关联集合，从而避免潜在的递归。
修改后的Project实体（包含Lombok优化）：
package com.example.technologyradar.model;import com.fasterxml.jackson.annotation.JsonManagedReference;import lombok.AllArgsConstructor;import lombok.Data;import lombok.EqualsAndHashCode; // 引入Lombok注解import lombok.NoArgsConstructor;import lombok.ToString; // 引入Lombok注解import org.hibernate.annotations.GenericGenerator;import javax.persistence.*;import java.util.HashSet;import java.util.Set;@Entity@Data@AllArgsConstructor@NoArgsConstructor@EqualsAndHashCode(of = "id") // 只基于id生成equals和hashCode@ToString(of = {"id", "name"}) // 只打印id和name字段public class Project { @Id @GeneratedValue(strategy = GenerationType.AUTO, generator = "native") @GenericGenerator(name="native", strategy = "native") private Long id; private String name; @ManyToMany(mappedBy = "projects") @JsonManagedReference private Set assignedTechnologies = new HashSet();}
修改后的Technology实体（包含Lombok优化）：
package com.example.technologyradar.model;import com.example.technologyradar.dto.constant.TechnologyStatus;import com.fasterxml.jackson.annotation.JsonBackReference;import lombok.AllArgsConstructor;import lombok.Data;import lombok.EqualsAndHashCode; // 引入Lombok注解import lombok.NoArgsConstructor;import lombok.ToString; // 引入Lombok注解import org.hibernate.annotations.GenericGenerator;import javax.persistence.*;import java.util.HashSet;import java.util.Set;@Entity@Data@AllArgsConstructor@NoArgsConstructor@EqualsAndHashCode(of = "id") // 只基于id生成equals和hashCode@ToString(of = {"id", "name", "technologyStatus"}) // 只打印id, name, technologyStatus字段public class Technology { @Id @GeneratedValue(strategy = GenerationType.AUTO, generator = "native") @GenericGenerator(name="native", strategy = "native") private Long id; private String name; @Enumerated(EnumType.STRING) private TechnologyStatus technologyStatus; @OneToOne(fetch = FetchType.EAGER, cascade = CascadeType.PERSIST, targetEntity = Category.class) @JoinColumn(name="category_id", referencedColumnName = "id", nullable = false) private Category category; @OneToOne(fetch = FetchType.EAGER, cascade = CascadeType.PERSIST, targetEntity = Coordinate.class) @JoinColumn(name="coordinate_id", referencedColumnName = "id", nullable = false) private Coordinate coordinate; @ManyToMany @JoinTable( name = "projects_technologies", joinColumns = @JoinColumn(name="technology_id"), inverseJoinColumns = @JoinColumn(name="project_id") ) @JsonBackReference private Set projects = new HashSet();}
通过这些Lombok注解的细化，即使在非序列化场景下，实体对象的行为也更加安全和可控。
其他处理策略
除了上述方法，还有几种策略可以处理JPA实体和JSON序列化：
使用@JsonIgnore：最简单粗暴的方法是在关系的一端直接使用@JsonIgnore注解。这会完全阻止该字段的序列化。
// 在Technology实体中@ManyToMany@JsonIgnore // 完全忽略projects字段的序列化private Set projects = new HashSet();
优点： 简单快捷。缺点： 可能会丢失部分需要在某些场景下序列化的数据。如果某个API确实需要Technology关联的Project信息，此方法就不适用。
数据传输对象（DTO）：将JPA实体与API响应解耦的最佳实践是使用DTO。DTO是专门为API响应设计的POJO，只包含客户端所需的数据，不包含JPA注解和复杂的关联关系。
优点：完全控制API响应结构，与数据库实体分离。避免暴露不必要的内部实体细节。易于测试和维护。实现：创建一个ProjectDTO和TechnologyDTO，并通过手动映射或使用ModelMapper、MapStruct等库将实体转换为DTO。
// ProjectDTO 示例public class ProjectDTO { private Long id; private String name; private Set assignedTechnologies; // 包含简化版的Technology信息 // 构造函数、getter/setter}// TechnologyDTO 示例public class TechnologyDTO { private Long id; private String name; private TechnologyStatus technologyStatus; // 不包含projects集合，或者只包含Project的ID/名称 // 构造函数、getter/setter}
在Service层将查询到的实体转换为DTO列表再返回。
@JsonIdentityInfo：当需要序列化整个对象图，并且希望Jackson能够识别并处理循环引用时，可以使用@JsonIdentityInfo。它会为每个对象生成一个唯一的标识符，并在遇到重复引用时只序列化该标识符。
@Entity@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")public class Project { // ...}@Entity@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")public class Technology { // ...}
优点： 序列化时保留了所有关联信息，且不会无限递归。缺点： 生成的JSON可能会包含额外的@id字段，并且结构可能不如DTO直观。
总结
解决Spring JPA实体在Jackson序列化时遇到的无限递归问题，关键在于管理好双向关联的序列化行为。@JsonManagedReference和@JsonBackReference是处理这类问题的首选方案，它们提供了一种清晰且可控的方式来打破循环引用。同时，结合Lombok的@EqualsAndHashCode(of = “id”)和@ToString(of = “id”)注解，可以进一步增强实体在非序列化场景下的健壮性。对于更复杂的业务场景，采用数据传输对象（DTO）模式则是将API响应与持久层实体解耦的最佳实践，它能提供最大的灵活性和可维护性。根据具体的业务需求和对JSON结构的要求，选择最合适的策略至关重要。
以上就是Spring JPA多对多关系中Jackson无限递归问题的解决方案的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1037996.html
微信扫一扫 
支付宝扫一扫 
