StackOverflowError 的本质是线程栈空间耗尽，由栈帧持续压入无法弹出导致；常见于失控递归、隐式循环调用、深度嵌套或单帧过胖，需通过堆栈日志定位调用模式并优化为迭代或显式栈。
StackOverflowError 的本质是线程栈空间耗尽，不是堆内存不足，也不是内存泄漏，而是 JVM 为每个线程分配的固定大小栈区被撑满——栈帧持续压入却无法弹出，最终触顶崩溃。
看堆栈日志，锁定重复调用模式
异常抛出时打印的完整调用栈是最直接线索：
- 重点观察顶部几十行：若连续出现同一方法名（如 parseJson、toString、render），大概率是失控递归或隐式循环调用
- 检查参数变化趋势：比如 loadNode(1024) → loadNode(1023) → loadNode(1022)… 持续递减但未抵达终止值，说明基础情形（base case）逻辑有漏洞（如漏判负数、边界条件写反）
- 警惕“看不见”的递归：重写了 toString()、equals() 或 hashCode()，而方法体内又间接触发自身（如日志打印对象、字段引用了本对象、JSON 序列化时循环引用）
排查非递归型栈压入压力
并非所有 StackOverflowError 都来自显式递归：
- 深度嵌套调用链：A→B→C→D→…→Z，哪怕每层都不调自己，若链长超 2000+ 层（尤其在解析深层 XML/JSON、AST 遍历场景），也可能溢出
- 单帧过“胖”：一个方法定义了大量局部变量、大数组引用、多层 final 字段初始化、或嵌套 synchronized 块，会显著增加单个栈帧占用空间，压缩可容纳层数
- 代理与增强干扰：Spring AOP、MyBatis 动态代理、或层层 Lambda 闭包，在调用链中插入大量拦截器帧，使实际有效调用深度被“虚增”
用工具和参数辅助定位
仅靠 try-catch 捕获不到 StackOverflowError（它是 Error，非 Exception），必须提前介入：
立即学习“Java免费学习笔记（深入）”；
- 加启动参数 -XX:OnError="jstack -l %p > stack_%p.log"，让 JVM 在崩溃瞬间自动 dump 线程栈，保留第一手现场
- 复现稳定时，加 -XX:MaxJavaStackTraceDepth=2000（默认 -1 可能因栈已满而截断），强制保留更多有效帧
- 别只盯异常第一行——关键线索常在倒数第 3～5 层，上面多是框架代理/序列化包装，要往堆栈底部翻找业务方法入口
- 用 jstack -l <pid> 抓取运行中线程栈，对比正常与异常线程的调用深度和帧结构差异
修复思路：从代码逻辑优先，而非调大栈
-Xss 调大只是临时缓解，且副作用明显（线程数上限骤降，高并发下易引发 OOM 或连接拒绝）：
- 对确定存在深调用的逻辑，改用 while 循环 + Deque<State> 显式栈，把状态从 JVM 栈移到堆内存，容量由堆大小决定
- 尾递归场景手动转循环（Java 不支持自动尾调用优化），消除栈增长
- 树/图遍历优先选 BFS（队列），或 DFS 中用 ArrayDeque 管理节点，避免依赖方法调用栈
- 检查 toString/equals 等重写方法，确保不触发对象图的循环展开；必要时加递归深度计数或访问标记位防护
