递归调用易触发 StackOverflowError，因线程栈空间小（128KB–1MB），每次调用压入栈帧，过深递归或隐式递归（如 equals/toString 误调自身）导致栈溢出；该错误不可捕获恢复。
为什么递归调用容易触发 StackOverflowError
Java 线程栈空间默认很小（通常 128KB–1MB，取决于 JVM 参数和平台），每次方法调用都会压入栈帧，保存局部变量、参数、返回地址等。一旦递归过深或存在隐式递归（如重写 equals 或 toString 时意外调用自身），栈帧持续累积，最终超出线程栈上限，JVM 直接抛出 StackOverflowError——这不是可捕获的异常，而是错误（Error），不能靠 try-catch 恢复。
常见诱因包括：
-
equals方法里直接或间接调用了this.equals(...)（比如没判 null、没判类型、用了未初始化的字段触发 getter 递归） -
toString中拼接了包含自身的对象（如"User{" + this.name + ", " + this.profile + "}"，而profile.toString()又引用回User） - 无终止条件或终止条件失效的递归算法（如二分查找漏写
low 判定，导致无限调用） - 代理类/动态字节码（如 CGLIB、Lombok @Data）生成的
toString/hashCode引入循环引用
如何快速定位是哪个类/方法在爆栈
启动 JVM 时加上 -XX:+PrintStackTraceOnExit 并不生效；真正有效的是加 -XX:+PrintGCDetails 配合 -XX:+PrintConcurrentLocks 也没用——关键要让错误发生时输出完整栈轨迹。最直接的办法是：
- 运行时加参数：
-XX:MaxJavaStackTraceDepth=1000（默认是 1024，但某些 JDK 版本会截断，设大点确保看到全路径） - 必加：
-XX:+PrintGCTimeStamps -Xlog:gc*:file=gc.log不相关，真正有用的是：-XX:+UseGCOverheadLimit无关；应使用：-XX:+ShowMessageBoxOnError（Windows 下弹窗）或更通用的：-XX:ErrorFile=./hs_err_%p.log，但日志里不一定含栈——所以首选：加-XX:+PrintGCDetails没用，改用-XX:+PrintConcurrentLocks也没用，唯一稳的：加-XX:+PrintStackTraceOnUncaughtException（JDK 19+ 支持），老版本就靠-XX:MaxJavaStackTraceDepth=5000+ 观察控制台第一屏报错 - 实际建议：本地复现时，用 IDE 调试模式跑，断点打在疑似递归入口（如
toString第一行），看调用链是否出现重复类名反复出现（如User.toString → Profile.toString → User.toString...） - 如果线上无法调试，可临时加 JVM 参数：
-XX:+UnlockDiagnosticVMOptions -XX:+LogVMOutput -XX:LogFile=jvm.log，再配合jstack -l抓当前所有线程栈，重点看java.lang.Thread.State: RUNNABLE下深度超 500 层的调用链
修复 toString/equals 循环引用的实操要点
Lombok 的 @Data 默认为所有字段生成 toString，遇到双向关联（如 User ↔ Order）必然爆栈。不能简单删注解，得精准控制。
- 禁用特定字段参与：
@ToString(exclude = "orders")或@ToString(of = {"id", "name"}) - 手动重写
toString时，对可能循环的引用字段，用 ID 替代对象："User{id=" + id + ", name='" + name + "', orderId=" + (order != null ? order.getId() : null) + "}" -
equals中避免调用可能触发 getter 的字段：比如other.getProfile().getName()若getProfile()返回this（误写成 return this;），就会递归；应先判空、再判类型、再逐字段比较（用Objects.equals(a, b)安全） - 用 IDE 自动生成的
equals和hashCode时，**务必取消勾选包含双向关联字段**（IntelliJ 在 Generate dialog 里可多选字段，别全选）
递归改迭代时要注意的边界细节
不是所有递归都能无脑套“栈模拟”，尤其涉及状态传递、分支顺序、回溯逻辑时。
- 尾递归（如阶乘、单链表遍历）最容易转：用 while 循环 + 显式变量维护状态，无需额外栈结构
- 树的深度优先遍历（如 JSON 序列化）必须用
Deque模拟调用栈，且注意子节点入栈顺序（前序 vs 后序） - 回溯算法（如全排列、N 皇后）改迭代后，需把“当前路径”和“可用选择集”都存进栈帧对象，否则丢失上下文
- JVM 本身不优化尾递归（不像 Scala 或 Kotlin），所以即使写成尾递归形式，栈深度仍线性增长，必须主动重构
最常被忽略的一点：线程栈大小可通过 -Xss2m 临时调大，但这只是掩耳盗铃——它不解决根本问题，反而可能掩盖更深层的设计缺陷（比如本该用迭代的地方硬写递归，或模型层存在不该有的强循环依赖）。真要调参，也得结合 jstack 分析出栈深度再定，而不是盲目设成 -Xss8m。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
