Spring Data Rest中@OneToMany关联引发StackOverflowError问题排查

嗨，这个问题我太熟悉了——你遇到的是JPA双向关联导致的JSON序列化循环引用问题！

为什么会出现StackOverflowError？ #

当你请求/api/questions/1时，后端会尝试把Question实体转换成JSON返回。但你的Question里持有List<Option> options集合，每个Option又反过来持有一个Question的引用。JSON序列化器（比如Spring默认的Jackson）处理这种双向关联时，会陷入无限递归：
Question → Option → Question → Option → ...
不断重复这个过程直到栈内存耗尽，最终抛出StackOverflowError。

而/api/questions列表接口正常，大概率是因为默认@OneToMany关联是懒加载（FetchType.LAZY），列表查询时并没有初始化options集合，序列化器没机会触发Option的序列化，自然不会进入循环。

解决方法（按推荐程度排序） #

1. 使用DTO（数据传输对象）——最佳实践

不要直接把JPA实体返回给前端，而是定义专门的DTO类，只暴露前端需要的字段，从根源上避免循环引用：

// QuestionDTO：只包含前端需要的问题信息
public class QuestionDTO {
    private Long id;
    private String title;
    private String content;
    // 只包含选项的必要信息，不携带Question引用
    private List<OptionDTO> options;
    
    // getter、setter、构造方法
}

// OptionDTO：只包含选项的核心字段
public class OptionDTO {
    private Long id;
    private String content;
    private Boolean isCorrect;
    
    // getter、setter、构造方法
}

在业务层将Question实体转换为QuestionDTO后再返回，这样既避免了循环问题，又能保护实体的内部结构，符合分层架构的设计原则。

2. 使用Jackson双向关联专用注解

如果你不想定义DTO，可以用Jackson提供的@JsonManagedReference和@JsonBackReference来标记双向关联的两端：

• 在Question的options字段上加@JsonManagedReference（主动端，会被正常序列化）：

@OneToMany(mappedBy = "question")
@JsonManagedReference
List<Option> options;

• 在Option的question字段上加@JsonBackReference（被动端，序列化时会被忽略）：

@ManyToOne
@JoinColumn(name="question_id")
@JsonBackReference
Question question;

这组注解能明确告诉序列化器如何处理双向关联，不会破坏实体之间的关联语义。

3. 用@JsonIgnore打断循环

最简单的方式是在其中一端的关联字段上添加@JsonIgnore，让序列化器忽略该字段：
比如在Option的question字段上添加：

@ManyToOne
@JoinColumn(name="question_id")
@JsonIgnore
Question question;

这种方式虽然快捷，但会完全忽略Option到Question的关联，如果后续业务需要这个关联的序列化，就会受影响，所以不如前两种方案灵活。

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