Spring下JPA与REST Controller @ManyToMany循环引用问题求解

你遇到的无限递归是Jackson序列化双向多对多关联实体时的典型问题：Teacher对象包含Section集合，每个Section对象又包含关联的Teacher集合，序列化过程会循环读取这两个关联字段，最终导致栈溢出或无限嵌套的JSON结构。

方案1：使用@JsonManagedReference + @JsonBackReference截断序列化 #

这是最轻量化的单向序列化截断方案，适合仅需要在Teacher接口返回关联Section的场景：

• 在Teacher类的多对多关联字段上添加@JsonManagedReference，标记该字段为序列化的父侧
• 在Section类的多对多关联字段上添加@JsonBackReference，标记该字段为序列化的子侧，序列化时会自动忽略该字段避免循环

代码示例：

// Teacher 类
@ManyToMany
@JsonManagedReference
@JoinTable(
    name = "teacher_section",
    joinColumns = @JoinColumn(name = "teacher_id"),
    inverseJoinColumns = @JoinColumn(name = "section_id")
)
private List<Section> sections;

// Section 类
@ManyToMany(mappedBy = "sections")
@JsonBackReference
private List<Teacher> teachers;

注意：该方案下调用Section的查询接口时，不会返回关联的Teacher列表，如果需要双向接口都支持返回关联数据，选择下一种方案。

方案2：使用@JsonIgnoreProperties指定忽略关联字段 #

该方案可以灵活控制序列化忽略的字段，同时支持双向关联的正常输出：

• 在Teacher的sections字段上添加@JsonIgnoreProperties("teachers")，序列化Section时忽略其teachers字段
• 在Section的teachers字段上添加@JsonIgnoreProperties("sections")，序列化Teacher时忽略其sections字段

代码示例：

// Teacher 类
@ManyToMany
@JsonIgnoreProperties("teachers")
@JoinTable(
    name = "teacher_section",
    joinColumns = @JoinColumn(name = "teacher_id"),
    inverseJoinColumns = @JoinColumn(name = "section_id")
)
private List<Section> sections;

// Section 类
@ManyToMany(mappedBy = "sections")
@JsonIgnoreProperties("sections")
private List<Teacher> teachers;

方案3：使用@JsonIdentityInfo按ID去重序列化 #

在两个实体类的类级别添加该注解，指定实体的唯一标识字段（通常是ID），序列化时如果遇到已经输出过的实体，会直接输出ID值而非重复序列化整个对象，适合需要保留完整关联层级的场景。
代码示例：

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Teacher extends AbstractEntity {
    // 类原有逻辑
}

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
public class Section extends AbstractEntity {
    // 类原有逻辑
}

方案4：自定义DTO做数据传输（推荐用于生产环境） #

该方案完全解耦实体层和接口输出层，避免序列化问题的同时可以灵活控制暴露给前端的字段，不会泄露实体的敏感属性：

• 自定义TeacherDTO和SectionDTO类，仅保留需要返回给前端的字段
• 业务层完成实体到DTO的属性转换后再返回给Controller

代码示例：

// TeacherDTO
@Data
public class TeacherDTO {
    private Long id;
    private String name;
    // 其他需要返回的教师字段
    private List<SectionDTO> sections;
}

// SectionDTO
@Data
public class SectionDTO {
    private Long id;
    private String sectionName;
    // 其他需要返回的班级字段，无需添加关联教师字段即可避免循环
}

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