那天晚上，我正窝在电脑前写 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岁程序员。如果你喜欢我的文章，欢迎关注我的微信公众号“软件求生”，获取更多技术干货！
