Spring REST API获取用户时出现StackOverflowError问题求助

出现java.lang.StackOverflowError且确认和递归相关时，90%以上的原因是实体类双向关联导致的序列化无限递归，或是toString()方法循环调用，以下是具体排查和解决步骤：

1. 优先排查实体类的双向关联序列化问题 #

这是Spring REST接口出现递归栈溢出的最常见场景：

• 检查你的User实体是否和其他实体（比如Role、Order等）存在双向关联（比如@OneToMany和@ManyToOne互相引用）
• 当Jackson序列化User对象时，会自动序列化其关联的对象，而关联对象又会反向序列化User，形成无限循环，最终触发栈溢出

解决方法： #

方法1：用Jackson注解打断递归链

在双向关联的两端添加注解，指定序列化时的忽略规则：

// User实体（关联的主动端）
@Entity
public class User {
    // ... 其他字段
    @OneToMany(mappedBy = "user")
    @JsonManagedReference // 标记为主动序列化端，正常输出关联数据
    private List<Role> roles;
}

// Role实体（关联的被动端）
@Entity
public class Role {
    // ... 其他字段
    @ManyToOne
    @JoinColumn(name = "user_id")
    @JsonBackReference // 标记为反向端，序列化时自动忽略该字段
    private User user;
}

方法2：直接忽略关联字段

如果不需要返回关联对象，直接在关联字段上添加@JsonIgnore：

// Role实体
@ManyToOne
@JoinColumn(name = "user_id")
@JsonIgnore // 序列化Role时跳过user字段，避免递归
private User user;

2. 检查实体类的toString()方法 #

如果实体类的toString()方法中包含了关联对象的引用，会导致打印/序列化时触发循环调用：

// 错误示例：User的toString()包含roles，Role的toString()又包含user
@Override
public String toString() {
    return "User{" + "id=" + id + ", username='" + username + '\'' + ", roles=" + roles + '}';
}

解决方法： #

修改toString()，只保留简单字段，或仅引用关联对象的ID而非整个对象：

@Override
public String toString() {
    return "User{" + "id=" + id + ", username='" + username + '\'' + '}';
}

3. 通过堆栈跟踪定位递归点 #

从StackOverflowError的堆栈日志中，找重复出现的方法调用链，比如连续出现：

at com.example.entity.User.getRoles(User.java:35)
at com.example.entity.Role.getUser(Role.java:28)
at com.example.entity.User.getRoles(User.java:35)
...

这种重复调用的字段就是递归的源头，直接针对该字段处理即可。

4. 改用DTO返回数据 #

如果不想修改实体类，建议创建UserDTO，仅包含需要返回给前端的字段，避免携带关联对象：

public class UserDTO {
    private Long id;
    private String username;
    private String email;
    // 只保留需要的字段，不包含双向关联的集合/对象

    // 构造方法：从User实体转换为DTO
    public UserDTO(User user) {
        this.id = user.getId();
        this.username = user.getUsername();
        this.email = user.getEmail();
    }
}

在服务层将User实体转换为UserDTO后返回给控制器，彻底避免序列化递归问题。

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