SpringBoot三层实体一对多映射请求返回调用栈溢出等异常如何解决

问题产生原因 #

• 核心为Jackson序列化时循环引用触发无限递归，最终导致最大调用栈溢出、JSON格式损坏：
  1. 即使配置了@JsonManagedReference与@JsonBackReference配对避免循环，若业务代码触发了LAZY关联的全量加载，或是序列化入口不是顶层PatientLabReport，三层嵌套关联仍可能触发递归序列化。
  2. SpringBoot默认开启的spring.jpa.open-in-view配置会自动加载LAZY关联实体，导致预期不加载的关联对象进入序列化上下文，触发循环。
  3. 当前配置存在属性命名不规范问题：LabTestNameByDoctor中mappedBy = "LabTestNameByDoctor"、LabReportList中对应属性名首字母大写，不符合Java小驼峰命名规范，可能导致Jackson注解匹配失效，触发循环序列化。

解决方案 #

方案1：快速修复验证 #

在所有多对一反向关联属性上添加@JsonIgnore注解，直接禁止序列化反向关联字段，彻底切断循环路径，可同步删除原有@JsonManagedReference与@JsonBackReference注解。

方案2：保留双向关联序列化能力 #

在三个实体类的类头统一添加@JsonIdentityInfo注解，指定用实体主键作为序列化标识，当序列化遇到重复实体时仅输出ID值，既避免循环，也保留关联关系标识：

import com.fasterxml.jackson.annotation.JsonIdentityInfo;
import com.fasterxml.jackson.annotation.ObjectIdGenerators;

// 三个实体类都添加该注解
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
@Entity
public class PatientLabReport {
    // 原有业务代码
}

方案3：生产环境最佳实践 #

额外定义接口返回DTO对象，仅赋值需要返回给前端的字段，不直接返回实体类作为接口响应，完全隔离实体关联关系与接口响应，从根源解决序列化问题，同时避免暴露实体敏感字段。

辅助优化配置 #

1. 关闭多余的open-in-view配置：在配置文件中添加spring.jpa.open-in-view=false，避免LAZY关联被意外加载。
2. 修正属性命名：将LabTestNameByDoctor中mappedBy值改为小驼峰labTestNameByDoctor，同步将LabReportList中的关联属性名改为小驼峰private LabTestNameByDoctor labTestNameByDoctor，避免框架属性映射异常。

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