Spring Boot多对多映射JSON无限递归问题求助

问题根源 #

双向多对多关联时，Student和Subject互相持有对方的集合引用，JSON序列化器会循环遍历两个实体的关联属性，最终触发StackOverflowError。你能正常获取Subject列表但Student列表报错，说明注解配置只覆盖了单方向的序列化逻辑。

可行解决方案 #

1. 正确配置@JsonIgnoreProperties #

在两个实体的关联属性上，互相排除对方的关联集合，切断循环引用链：

• Student实体代码调整：

@ManyToMany(mappedBy = "enrolledStudents")
@JsonIgnoreProperties("enrolledStudents") // 排除Subject中的Student集合
private Set<Subject> subjects;

• Subject实体代码调整：

@ManyToMany
@JoinTable(
    name = "student_subject",
    joinColumns = @JoinColumn(name = "subject_id"),
    inverseJoinColumns = @JoinColumn(name = "student_id")
)
@JsonIgnoreProperties("subjects") // 排除Student中的Subject集合
private Set<Student> enrolledStudents;

注意：注解内的属性名必须和对方实体中定义的集合变量名完全一致，拼写错误会导致注解失效。

2. 用@JsonManagedReference + @JsonBackReference标记关联方向 #

这组注解用于区分序列化的"主动端"和"被动端"，多对多场景下可指定一个方向输出关联数据，另一个方向忽略：

• Student实体（主动端）：

@ManyToMany(mappedBy = "enrolledStudents")
@JsonManagedReference
private Set<Subject> subjects;

• Subject实体（被动端）：

@ManyToMany
@JoinTable(...)
@JsonBackReference
private Set<Student> enrolledStudents;

此方案下序列化Student会正常输出subjects，但序列化Subject时不会输出enrolledStudents；若需要双向都能序列化，优先选第一种方案。

3. 用@JsonIdentityInfo标记对象身份 #

给两个实体添加该注解，让Jackson序列化时识别对象唯一ID，重复出现的对象直接用ID代替，避免循环遍历：

@Entity
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Student {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他属性、关联集合
}

@Entity
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Subject {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他属性、关联集合
}

适合需要保留双向关联完整信息的场景。

4. 使用DTO（推荐新手长期采用） #

创建与实体对应的DTO类，只封装前端需要的字段，避免直接序列化实体：

• 示例DTO代码：

// StudentDTO
public class StudentDTO {
    private Long id;
    private String studentName;
    private List<SubjectMinDTO> subjects;

    // 构造器、getter/setter
}

// SubjectMinDTO
public class SubjectMinDTO {
    private Long id;
    private String subjectName;

    // 构造器、getter/setter
}

在Service层将Student实体转换为StudentDTO后再返回前端，从根源上避免实体关联导致的序列化问题，同时符合分层架构设计。

排查注意事项 #

• 检查注解中的属性名是否与实体集合变量名完全匹配，大小写、拼写错误都会导致注解失效。
• @JsonIgnore会完全忽略属性的序列化和反序列化，若需要保留某方向的关联数据，不要使用该注解，改用@JsonIgnoreProperties。

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