一次JPA联表查询，竟让我服务器无限循环崩溃？！



那天晚上，我正窝在电脑前写 Spring Boot 项目，耳机里放着轻音乐，猫趴在键盘旁边。

一切看似岁月静好，直到我敲下一个 innocently 的 JPA 查询语句：

我刷新接口，准备看返回的 JSON，结果浏览器直接——炸了。

没错，页面疯狂刷新、日志滚屏，最后 Eclipse 哭着给我抛了一个熟悉又讨厌的错误：

那一刻，我整个人都不好了。“这……是我写错了吗？我只是查个表啊！”

那场“无限递归”的噩梦

事情要从我的实体类说起。那时我定义了两个表：User 和 Department。

• 每个用户属于一个部门；
• 每个部门有多个用户。

于是我很自然地写了这样的实体：

是不是看起来很正常？我信心满满地执行了 userRepository.findAll()。然后就触发了那场“无限递归”的地狱循环。

原因很简单：

• User 中的 Department 包含 users；
• Department 又返回 User；
• User 又嵌套 Department；
• 就这样，一层套一层，递归到天荒地老。

Spring 序列化 JSON 时，根本停不下来，直到栈爆了。

遇见“温柔”的 @JsonBackReference

我苦思冥想，直到看到一个答案上写着：

我试了试。

在 User 里加上：

在 Department 里加上：

我重启项目，再次调用接口~哇！终于不炸了！结果只显示了：

而不是无限嵌套的“俄罗斯套娃”。

那一刻，我感动得差点给 @JsonBackReference 立个牌位。

那么 @JsonManagedReference 和 @JsonBackReference 究竟干嘛的？

其实它俩就像一对恋人：

• @JsonManagedReference：是“正向”一方，告诉 Jackson：“你可以序列化我！”
• @JsonBackReference：是“反向”一方，告诉 Jackson：“我别参与序列化，否则会无限循环！”

这对注解常用于 双向关联（bidirectional relationship） 的场景。

举个例子：

• 一个部门下有很多员工；
• 员工反向指向部门。

如果都序列化，就死循环。加上这两个注解后，Jackson 就知道该“止步”了。

那 @JSONField(serialize = false) 又是啥？

当我以为事情就这么结束时，另一个坑又出现了。

项目里某个模块用的是 FastJSON 库，而不是 Jackson。我重新跑接口，发现——递归又回来了！因为 FastJSON 并不识别 @JsonBackReference。

于是我又查资料，发现 FastJSON 的对应解决方案是：

意思是：

我赶紧在 User 类上加上：

问题又一次解决了！

Json 序列化背后的真相

我后来想了很久，其实问题的根本原因不是注解本身，而是JPA 的双向关系与JSON 的树形结构之间的“理念冲突”：

当 JPA 在内存里维护“相互引用”时，Jackson/FastJSON 却只能线性地展开。于是，注解其实是让两者“和平共处”的调节器。

实战：Spring JPA 联表查询 + 注解完美配合

举个最常见的例子：

我们要查询一个部门的所有员工。

如果没加注解，这个接口直接会炸掉。但如果你的 Department 类里是这样写的：

User 类里是这样写的：

那查询结果就会完美输出：

没有递归，没有爆栈，干净利落。

常见误区：你可能犯过这些错

误区一：只加一边的注解

很多人只在 User 上加 @JsonBackReference，结果 Department 输出不了用户列表。其实要配对使用，一对组合才能互相识别。

误区二：混用懵圈

如果你同时用了 FastJSON 和 Jackson，结果可能完全反着来。解决办法：

• 如果项目使用 Spring Boot 默认的 Jackson，只用 @JsonBackReference；
• 如果使用 FastJSON，就用 @JSONField(serialize = false)；
• 如果不确定，就两个都加。

误区三：以为 @Transient 能解决

@Transient 会直接让字段在 JPA 层忽略，根本查不到数据。别搞混。

给刚入坑的同学一个建议

很多人学 JPA 时，都只关注 CRUD，但实际上——

尤其是当你第一次在项目里写出这种查询：

却发现接口报错、序列化卡死，那一刻，你就会明白：

后记：@JsonBackReference 的温柔与克制

写到这里，我忍不住有点感慨。

@JsonBackReference 像极了一个在关系中学会克制的人。它不是不爱，而是知道——

它静静地站在反向引用那一边，说：

程序世界，也有温柔与边界。总结

最后，我们把今天的知识点捋一捋：

END

Spring JPA 的联表查询其实并不可怕，可怕的是我们对“关系”的不了解。

就像现实世界的情感一样，每一段关系都需要有“界限”——

下次当你遇到 JSON 无限递归时，记得微笑着给 @JsonBackReference 一个拥抱。

因为那一刻，它不是让你少了点什么，而是帮你挽救了整个系统。

我是小米，一个喜欢分享技术的31岁程序员。如果你喜欢我的文章，欢迎关注我的微信公众号“软件求生”，获取更多技术干货！