JPA双向关联(OneToMany/ManyToOne)引发StackOverflowError的原因与解决

问题背景 #

项目基于JPA实现Department和Employee的双向关联（Department为OneToMany，Employee为ManyToOne），调用API时出现StackOverflowError，删除Department实体的getter/setter后问题解决，但需要明确原因及满足「按部门ID查询员工」需求的有效方案。

为什么双向关联会引发无限递归？ #

当API返回实体对象时，JSON序列化框架（比如Jackson）会通过调用实体的getter方法遍历对象属性：

• 序列化Department时，会调用getEmployees()获取员工列表；
• 每个Employee对象又有getDepartment()方法，会指向原Department对象；
• 序列化框架会再次处理这个Department的getEmployees()，如此循环往复，直到栈内存耗尽，抛出StackOverflowError。

即使设置了FetchType.LAZY，序列化过程中调用getter会触发懒加载，加载关联的Employee数据，进而触发递归。删除Department的getter/setter后，序列化框架无法获取employees字段，自然终止了递归，但这属于治标不治本的临时方案。

有效解决方案 #

1. 使用Jackson双向关联注解（最简单直接） #

利用Jackson提供的注解打断递归链：

• 在**Employee的department字段**上添加@JsonBackReference：该注解标记的属性在序列化时会被忽略，避免反向引用触发递归；
• 可选在**Department的employees字段**上添加@JsonManagedReference：标记主动序列化的关联属性，和@JsonBackReference配对使用，明确双向关联的序列化方向。

修改后的Employee实体关键代码：

@ManyToOne
@JoinColumn(name = "department_id")
@JsonBackReference // 添加此注解
private Department department;

修改后的Department实体关键代码：

@OneToMany(mappedBy = "department", fetch = FetchType.LAZY)
@JsonManagedReference // 可选，和上面的注解配对
List<Employee> employees;

2. 忽略指定序列化字段 #

如果不需要在返回结果中包含Department的员工列表，直接在Department的employees字段或其getter上添加@JsonIgnore：

@OneToMany(mappedBy = "department", fetch = FetchType.LAZY)
@JsonIgnore // 添加此注解，序列化时忽略该字段
List<Employee> employees;

这种方式适合不需要返回部门下员工列表的场景，若后续有动态需求，可结合Jackson视图功能实现字段的按需序列化。

3. 使用DTO（数据传输对象）推荐 #

创建专门的DTO类，只包含API需要返回的字段，避免直接序列化实体对象：

• 比如创建EmployeeDTO，包含员工的id、name、position，以及部门的id、name（而非整个Department实体）；
• 在Service层将JPA实体转换为DTO后再返回给Controller。

示例DTO代码：

public class EmployeeDTO {
    private Long id;
    private String name;
    private String position;
    private DepartmentSimpleDTO department;

    // getter/setter、构造方法
}

public class DepartmentSimpleDTO {
    private Long id;
    private String name;

    // getter/setter、构造方法
}

这种方式完全隔离了实体层和API返回层，既避免序列化递归问题，又能灵活控制返回数据结构，适合复杂业务场景。

4. 针对「按部门ID查询员工」的优化 #

当按部门ID查询员工时，核心需求是返回该部门下的所有员工信息，此时可以：

• 用上述注解方案，确保序列化Employee时不会递归序列化Department的员工列表；
• 或者使用DTO，返回包含员工基本信息和部门精简信息的结构，既满足需求又避免递归。

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