Spring Boot JPA多对多关联使用@JsonIgnore规避循环时关联字段缺失如何解决

双向关联实体JSON序列化时会触发循环递归问题，单纯使用@JsonIgnore只能全局屏蔽某一侧的关联字段，无法满足两侧查询都需要展示关联集合的需求，以下是三种可行方案：

方案1：使用@JsonIgnoreProperties做局部字段忽略（改造成本最低） #

无需删除原有关联注解，仅在双向关联字段上指定忽略对方的嵌套关联字段即可，从根源上切断循环递归路径：

改造代码： #

// Course类的students字段
@ManyToMany(fetch = FetchType.LAZY,cascade = CascadeType.ALL, mappedBy="courses")
@JsonIgnoreProperties("courses") // 序列化学生列表时，忽略学生对象里的courses字段，切断循环
private List<Student> students = new ArrayList<>();

// Student类的courses字段
@ManyToMany(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
@JoinTable(name = "student_course",
    joinColumns = {@JoinColumn(name= "student_id")},
    inverseJoinColumns = {@JoinColumn(name="course_id")})
@JsonIgnoreProperties("students") // 序列化课程列表时，忽略课程对象里的students字段，切断循环
private List<Course> courses = new ArrayList<>();

效果： #

• 查询Student时，返回的courses列表中不会嵌套students字段
• 查询Course时，返回的students列表中不会嵌套courses字段
• 无需新增额外类，完全适配现有业务逻辑。

方案2：自定义DTO传输对象（生产环境最推荐） #

避免直接返回JPA实体类到前端，单独定义业务层传输对象按需组装字段，从结构上彻底避免循环依赖，同时还能隐藏实体敏感字段、灵活适配前端需求：

示例DTO定义： #

// 学生传输类，关联的课程仅返回基础信息
@Data
public class StudentDTO {
    private Long id;
    private String firstName;
    private String lastName;
    private String contactNumber;
    private int GPA;
    private String email;
    private List<CourseSimpleDTO> courses;
}

// 课程基础传输类，不包含学生关联
@Data
public class CourseSimpleDTO {
    private Long id;
    private String title;
    private int credit;
    private String location;
    private String session;
}

// 课程传输类，关联的学生仅返回基础信息
@Data
public class CourseDTO {
    private Long id;
    private String title;
    private int credit;
    private String location;
    private String session;
    private List<StudentSimpleDTO> students;
}

// 学生基础传输类，不包含课程关联
@Data
public class StudentSimpleDTO {
    private Long id;
    private String firstName;
    private String lastName;
    private String email;
}

业务层查询到实体后，手动或者用MapStruct等工具转换为对应DTO返回即可。

方案3：使用@JsonIdentityInfo全局对象标识 #

在两个实体类上添加Jackson提供的对象标识注解，序列化时遇到已经输出过的对象，会直接用ID值代替，不会重复序列化：

改造代码： #

// 在Course类上添加
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
@Data
@Entity
@Table(name="course")
public class Course {
    // 原有字段不变，删除students上的@JsonIgnore
}

// 在Student类上添加
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
@Data
@Entity
@Table(name="student")
public class Student {
    // 原有字段不变
}

注意： #

该方案输出的JSON中，嵌套的关联对象第二次出现时只会显示ID值，结构和前两种方案略有差异，适合对返回格式要求不高的场景。

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