Spring Boot集成JPA时saveAll返回数据触发StackOverflowError

嘿，这个问题我之前踩过坑！咱们先理清楚问题根源，再给你几个可行的解决方案：

问题原因 #

你遇到的java.lang.StackOverflowError是双向关联实体的JSON序列化循环引用导致的：

• 你的AddressModel和EmployeeModel是双向关联（@ManyToOne + @OneToMany）
• 当Spring MVC把List<AddressModel>序列化为JSON返回前端时，会先序列化每个AddressModel，里面包含emp_id（EmployeeModel实例）
• 接着序列化EmployeeModel时，它又包含address集合（里面是AddressModel实例）
• 这样就会无限递归序列化，直到栈内存耗尽抛出异常

而且你提到saveAll能正常执行，说明数据库操作没问题，问题完全出在返回结果的序列化环节。

解决方案 #

方案1：用@JsonIgnore阻断循环 #

在双向关联的其中一方字段上添加@JsonIgnore，让JSON序列化时忽略这个关联字段，打破循环：

// 在EmployeeModel的address字段上添加注解
@OneToMany(mappedBy="emp_id")
@JsonIgnore
private Collection<AddressModel> address = new ArrayList<>();

这个方法简单直接，但缺点是如果后续需要返回包含地址集合的员工信息，这个字段会被直接忽略，灵活性不足。

方案2：用Jackson双向关联专属注解 #

Jackson提供了@JsonManagedReference和@JsonBackReference来专门处理双向关联的序列化：

• @JsonManagedReference：标记父级的关联字段（被主动序列化的一方）
• @JsonBackReference：标记子级的关联字段（被忽略序列化的一方，避免循环）

修改你的实体类：

// EmployeeModel 中
@OneToMany(mappedBy="emp_id")
@JsonManagedReference
private Collection<AddressModel> address = new ArrayList<>();

// AddressModel 中
@ManyToOne
@JoinColumn(name="emp_id")
@JsonBackReference
private EmployeeModel emp_id;

这个方案比@JsonIgnore更灵活，它只是控制序列化的方向，不会完全丢失关联信息。

方案3：使用DTO（数据传输对象）【推荐】 #

不要直接返回JPA实体类，而是定义专门的DTO类，只包含需要返回给前端的字段，从根源上避免实体关联的序列化问题：

1. 定义AddressDTO：

public class AddressDTO implements Serializable {
    private Integer addressId;
    private String city;
    private String states;
    private Integer empId;

    // 构造方法、getter、setter
}

2. 在Controller中把AddressModel转换为AddressDTO再返回：

@RequestMapping(path = "/post-addr", method = RequestMethod.POST)
public List<AddressDTO> postAddr(@Valid @RequestBody List<AddressRequest> addr1){
    // ... 原有代码逻辑不变 ...
    List<AddressModel> addr3 = addr.saveAll(addr_list);
    
    // 转换为DTO返回
    List<AddressDTO> response = addr3.stream()
        .map(address -> {
            AddressDTO dto = new AddressDTO();
            dto.setAddressId(address.getAddress_id());
            dto.setCity(address.getCity());
            dto.setStates(address.getStates());
            dto.setEmpId(address.getEmpId());
            return dto;
        })
        .collect(Collectors.toList());
    
    return response;
}

这个方案是业界推荐的最佳实践，因为实体类应该专注于数据库交互，DTO则负责和前端交互，不仅能避免循环引用，还能防止敏感字段泄露，同时更易维护。

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