
最近一次在 CI 上接一个大分支构建跑了几十分钟突然弹出一屏红字An exception has occurred in the compiler下面跟着一大串java.lang.StackOverflowError堆栈全是com.sun.tools.javac.*。当时第一反应是我们又不是运行递归程序怎么会在编译阶段栈溢出排查了一整天最后发现问题出在一份自动生成的 Java 源文件上——嵌套层级太深把 javac 的递归栈给打穿了。这篇文章就把完整的问题分析链路写下来javac 为什么会栈溢出、哪些代码最容易触发、怎么从崩溃现场一步步定位到具体源码、临时怎么救火、长期怎么根治。给所有写过「能编译但代码很变态」的项目的同学一个参考。1. 症状识别编译期的 StackOverflowError 和运行期完全不是一回事1.1 崩溃现场长什么样如果你是在命令行或构建日志里第一次见到这种错误它的长相一般是这样的An exception has occurred in the compiler (21.0.1). Please file a bug against the Java compiler team... java.lang.StackOverflowError at com.sun.tools.javac.comp.Attr.visitApply(Attr.java:1234) at com.sun.tools.javac.comp.Attr.visitMethodDef(Attr.java:9876) ...注意几个关键信号错误类型叫StackOverflowError不是编译错误也不是OutOfMemoryError。堆栈里全是com.sun.tools.javac.*的内部帧几乎没有你自己业务代码的帧。崩溃发生在编译的命令行工具进程里运行期应用根本没有启动。运行时递归栈溢出是业务代码自己写出来的 Bug比如递归方法漏掉了终止条件编译期栈溢出则是 javac 在处理某个 Java 源文件时内部某个递归算法走得太多层把当前线程的调用栈用完了。两者名字一样成因和处置方式完全不同。运行期的栈溢出要改业务逻辑编译期的栈溢出大概率要改源代码的「形状」而不是改算法。1.2 它为什么会崩在编译过程里javac 本质上是一个把源码看成树、再递归处理这棵树的程序。Java 语法里有嵌套的括号、嵌套的类声明、嵌套的泛型参数、嵌套的方法调用这些天然形成一棵很深的 AST抽象语法树。javac 从读文件到输出字节码有十几个阶段绝大多数阶段都用递归下降的方式去访问 AST编译阶段主要递归行为引入内部类解析递归下降解析括号、表达式、类声明com.sun.tools.javac.parser.JavacParser符号录入递归进入嵌套的类作用域com.sun.tools.javac.comp.Enter类型检查递归访问每个 AST 节点做类型归约com.sun.tools.javac.comp.Attr数据流分析递归检查语句块的可达性和变量赋值com.sun.tools.javac.comp.Flow语义翻译/降级递归处理内部类、匿名类、Lambdacom.sun.tools.javac.comp.Lower字节码生成递归遍历语法树生成指令com.sun.tools.javac.jvm.Gen大部分代码比如你的业务代码嵌套深度只有几十层javac 的默认线程栈一般 512KB 到 1MB绰绰有余。但一旦源文件的某个维度出现「极端深度」——几千层甚至上万层的泛型嵌套、括号嵌套、链式调用——递归深度就会逼近甚至超过栈容量于是 StackOverflowError 就来了。这里要澄清一个认知误区这不是 javac 唯一的 Bug而是「递归算法 极端输入」的必然结果。极少数情况下确实是 javac 自身的回归缺陷但大部分时候是被编译的代码形态触碰到了栈的边界。1.3 先别急着改代码判断边界在动手排查之前可以先快速判断一下这个崩溃是不是「版本相关」的。同一份代码A 版本 JDK 编译崩溃B 版本 JDK 编译正常这种情况在 Java 8 到 21 的演进中很常见。原因是 javac 每个版本都在内部迭代优化——有些递归改成了循环有些递归深度限制被调高——但对 AST 的访问本质上仍是递归的。所以「换一个 JDK 就好了」不代表问题不存在它只是把边界往后挪了一点。我的建议是先按下面的排查链路把问题代码找出来再决定是改代码还是换版本。2. 高危代码画像什么样的源文件会把编译器递归栈打穿根据我接触到的实际案例最常触发这个问题的代码有四种形态按频率排序如下。2.1 深嵌套泛型类型泛型的嵌套是最大的重灾区。比如在一个对象上叠加很多层List、Map、Optional或者写一个超深的泛型别名// 手工写不太现实一般是自动生成的 class DeepBox { ListListListListListString field1; ListListListListListListString field2; }嵌套层数到几百层之后javac 在类型检查时需要递归计算类型擦除、递归判断子类型关系、递归做捕获转换每一层操作都要压栈。手工代码很少写到 50 层以上但数据模型生成器、协议代码生成器、JSON 结构转 Java 类工具很容易生成这种「俄罗斯套娃」类型。我遇到过一个极端案例一个自动生成的配置类里面连续嵌了 400 层MapString, ...javac 在Attr阶段直接崩掉。2.2 超深表达式与链式调用第二种是超长表达式。比如一个被几千层括号包裹的常量表达式int x (((((((((((((((((((1 2))))))))))))))))))));以及超长的链式调用SomeType result service .step1() .step2() .step3() // ... 连续几百个调用 .step1000();这两种写法都会让 AST 变成一条很深的链。括号嵌套对应解析阶段的term()递归链式调用对应Select节点的递归访问。流式 APIStream 加 LambdaBuilder 模式尤其容易触发因为每一步调用都可能带泛型参数类型检查阶段会叠加更多递归。注解处理器生成代码时特别喜欢生成这种长链因为生成器写一个append(a().b().c()...)实在太方便了。2.3 大规模继承层级与匿名类嵌套第三种是继承层级过深。class A1 extends A0、class A2 extends A1……一路继承下去到几千层的时候javac 在解析方法调用、查找覆写关系、计算isSubtype时会对父类链进行深度遍历。旧版本 JDK 上几百层继承就可能出问题新版 JDK 在这方面做了很多迭代化改造风险大幅降低但极端情况下仍然可能触发。匿名类嵌套类似。new A(new B(new C(...)))这种写法每个匿名类都要建立「外部实例链」Lower阶段会沿着嵌套层级逐层校正this的引用嵌套深度过大也可能溢出。2.4 注解处理器生成的「巨型源文件」这是现代 Java 项目里最典型、也最容易被忽略的场景。代码生成器注解处理器、DSL 转换器、OpenAPI 生成器会一次性生成很大的源文件而生成器通常不会考虑「生成的代码嵌套深度」把整个数据模型按嵌套结构递归地生成一个类生成 1000 层嵌套类型把一个深层 JSON 结构直接映射成MapString, MapString, Map...把一大段 DSL 翻译成一条超长方法链。如果项目是「手工代码 生成的代码」混合编译手工部分编译正常只有生成部分一进来就崩几乎可以锁定问题在生成器侧。这里给一个可以本地复现的「压力测试」脚本用来验证你对这个问题的理解。用 Python 生成一份深嵌套泛型的源码然后尝试编译# gen_deep.py n 500 # 从 100 开始逐步调大观察崩溃临界点 t String for _ in range(n): t List t with open(Deep.java, w) as f: f.write(class Deep { ) f.write(t field;) f.write( }\n)然后执行javac Deep.java把n从 100、200、500、1000 逐级往上加你会得到一个崩溃临界值。这个值和你机器的默认线程栈大小、javac 版本都有关没有统一的「标准答案」但它能帮你直观地理解「临界点」这个概念。3. 定位问题代码的完整排查链路遇到编译期 StackOverflowError最容易犯的错误是直接调大栈然后继续编译。调大栈确实经常管用但如果你不知道是哪段代码引发的下次生成器重新生成代码可能又崩。完整的排查链路应该是下面四步。3.1 先收集完整现场崩溃日志和 -verbose 输出第一件事把崩溃现场完整留下来。如果你只看到 CI 日志里的最后十几行很可能错过关键信息。建议本地直接复现编译命令加上-verbose把输出导到文件javac -verbose -d out srcs.txt 2 compile.log-verbose会打印 javac 正在处理哪个文件、正在加载哪个类、正在检查哪个类。崩溃前后最后一行日志通常就是压垮骆驼的那根稻草——比如「正在检查 XX 类」或者「正在加载某个生成类」。这个信息能帮你快速判断问题出在哪个源文件。如果项目文件很多先不要一次全编译。把源码列表拆开一组一组编译找到崩溃的那一组。这一步能做二分法第一次编前半部分第二次编后半部分哪个崩就锁定在哪一半。3.2 按异常堆栈里的内部帧判断崩溃阶段javac 崩溃时输出的内部堆栈不是乱码它是可以读的。每一段内部帧都告诉你崩在哪个编译阶段堆栈中出现的关键帧判断结论com.sun.tools.javac.parser.JavacParser崩在解析阶段多半是括号嵌套、表达式链过深com.sun.tools.javac.comp.Enter崩在符号录入阶段关注类声明嵌套、继承结构com.sun.tools.javac.comp.Attr崩在类型检查阶段优先怀疑泛型嵌套、类型归约、方法解析com.sun.tools.javac.comp.Flow崩在数据流分析阶段关注异常处理、赋值分析相关的超长语句块com.sun.tools.javac.comp.Lower崩在降级转换阶段关注匿名类、内部类、Lambda 的大规模嵌套com.sun.tools.javac.jvm.Gen崩在字节码生成阶段关注超长方法体/表达式树例如堆栈全是Attr.visitApply那就说明类型检查阶段在递归访问方法调用节点时溢出。你就能把注意力集中到「方法调用链」「泛型方法」「重载解析」这几类代码上而不是去检查文件里那些不相干的部分。3.3 文件级二分测试锁定到单个文件之后继续做文件内的二分。把文件复制一份删掉后半部分看是否崩溃再调整删除范围直到找到「删掉就不崩、加上就崩」的最小代码块。注意这个「最小代码块」不一定是唯一元凶它只是压垮递归栈的最后一层真实触发源可能是文件里多个深嵌套结构叠加后的总和。对生成代码来说文件级二分往往不太现实——生成器一重新生成整个文件又回来了。所以更高效的做法是在生成器模板里加一个「深度统计」功能让它输出生成结果的最大嵌套深度然后观察崩溃时的深度就知道是不是生成逻辑没有限制递归深度。3.4 源文件内部的块级排除与生成器溯源手工代码用二分法找到问题块之后还要回到生成器去溯源。比如一个 JSON Schema 生成器生成的类型深度完全取决于输入 JSON 的嵌套深度。如果你发现「输入数据嵌套 50 层就崩」那就不能只改单次生成的代码而要在生成器里加深度校验// 伪代码示意生成器侧限制深度 int maxDepth computeMaxDepth(schema); if (maxDepth 60) { throw new GeneratorException(schema 嵌套过深超过生成器安全上限); }这里有个实用小技巧很多 javac 内部选项虽然不公开但可用于诊断。比如-XDshould-stop.at阶段名可以让编译器在某阶段完成后停止配合前面的阶段判断能更精确地隔离崩溃阶段javac -XDshould-stop.atPARSE Deep.java # 如果依然崩说明解析阶段就溢出了 javac -XDshould-stop.atENTER Deep.java # 到 Enter 就崩问题在类结构处理 javac -XDshould-stop.atATTR Deep.java # 到类型检查才崩问题在类型归约这个选项不是公开 API不能指望它在所有版本上都生效但它作为诊断工具非常好用。用法是逐级提高阶段名看哪一级开始编译不通过就能确认崩溃发生在哪个阶段。注意这只是「诊断用」不要写进构建脚本。4. 应急缓解临时扩大编译器栈让构建先跑起来如果你的项目已经被阻塞在构建这一步最优先的需求是「让流水线先绿」。这时候最立竿见影的办法就是给 javac 所在的 JVM 线程加大栈。4.1 javac 命令行-J-Xssjavac启动时可以通过-J把参数传给运行 javac 的 JVM-Xss就是线程栈大小javac -J-Xss4m -d out srcs.txt如果 4MB 不够就继续加8MB、16MB 我都试过。有一个非常关键的经验不要把栈无限调大。栈值是按线程分配的调得越大JVM 能开的线程就越少而且如果代码本身的嵌套深度是几万层栈调大往往只是推迟崩溃最终可能转成内存占用问题。我的建议是设置一个「够用但不过分」的值比如 4MB 到 8MB等定位到问题代码后立刻把这个临时方案撤掉。4.2 主流构建工具里的配置方式实际项目很少直接敲javac基本都是 Maven、Gradle 或 Ant。不同工具下调栈的方式差别很大。Maven 默认编译是「进程内」的编译器跑在 Maven 自己的 JVM 里。最简单的方式是设置 Maven 进程的 JVM 参数export MAVEN_OPTS-Xss8m mvn compile如果你希望只作用于编译器插件可以 fork 出独立进程单独给 javac 传参plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId configuration forktrue/fork compilerArgs arg-J-Xss8m/arg /compilerArgs /configuration /pluginGradle 里 Java 编译默认跑在 Gradle daemon 进程内。要影响编译器栈要么改 daemon 参数要么让编译任务 fork 出独立进程// gradle.properties org.gradle.jvmargs-Xmx2g -Xss8m// build.gradle tasks.withType(JavaCompile).configureEach { options.fork true options.forkOptions.jvmArgs [-Xss8m] }两条路选一条即可我个人推荐后者改动范围小不会影响整个构建 daemon 其他任务的内存模型。Ant 的 javac 任务本身支持 fork 和 compilerarg配置最直接javac srcdirsrc destdirclasses forktrue compilerarg line-J-Xss8m/ /javac构建工具推荐做法生效范围命令行javac -J-Xss8m仅当前 javac 进程MavenMAVEN_OPTS-Xss8m或 fork -J-Xss8mMaven 进程内编译器 / 独立 javacGradleoptions.forkOptions.jvmArgsJavaCompile 任务独立进程Antforktruecompilerarg line-J-Xss8m/javac 任务4.3 换 JDK / 交叉验证以及「调栈只是缓兵之计」另一个应急手段是换 JDK 版本。某些版本对递归的改进比较大比如新版把某个递归遍历改成了显式栈同一份代码在新版就能编译通过。但交叉验证的主要目的是确认「这是代码问题还是编译器问题」如果在多个 JDK 上都崩基本说明代码形态确实触到了所有版本的递归边界如果只在某一版崩可能撞上了那个版本的回归 Bug。无论哪种情况调栈都只是缓兵之计你真正要做的是回到第 2 节和第 3 节把问题代码挖出来。5. 根治与预防代码重构方向和工程化防御5.1 手写代码的扁平化改写如果你的手工代码因为嵌套过深触发了问题重构方向只有三个字做扁平化。超长链式调用要拆。把一段 500 步的 Builder 链拆成多个中间变量每段 50 步左右语义不变但 AST 深度大幅下降。这不仅能解决编译问题还能让堆栈报错时定位到具体步骤调试体验好得多。// 改写前一层长链 Order order client.request(...) .addItem(item1) .addItem(item2) // ...几百行 .build(); // 改写后分段构建 Order.Builder builder client.request(...); for (Item item : items) { builder.addItem(item); } Order order builder.build();深嵌套泛型要抽象命名。虽然没有真正的类型别名但可以定义有意义的接口和类来缩短泛型深度。比如原始类型是MapString, MapString, ListString可以定义class NameMap extends LinkedHashMapString, MapString, ListString或者定义一个专门的接口把这种深度封装起来。代码的「语义」比「写法」重要泛型嵌套写出来的省事长期维护成本高编译器也会记着这笔账。超深括号表达式直接拆成带名字的中间常量。不要在一个表达式里堆几千个括号编译器解析它和人类阅读它付出的代价是一样大的。5.2 生成器侧改造的三条铁律生成代码才是这个问题的真正大头我认为有三条铁律第一条生成器要内置深度限制。凡是能递归生成嵌套结构的生成器都要算最大深度超过安全阈值要么报错要么用「引出中间变量」的方式把深度打平。比如生成深层类型时把每一层映射到一个中间类而不是一个类里嵌 400 层泛型。第二条生成器要优先生成「扁平结构」。能用多条语句、多个类表达的就不要生成一条超长表达式。生成器写起来麻烦一点但生成结果的鲁棒性完全不同。我见过一个团队改生成器时专门写了一个「AST 深度检测」的 visit 函数在生成后立即跑一遍超过阈值就 fail效果很好。第三条生成的代码要可读。生成代码也是要进代码仓库的要有注释要有正常的换行缩进。一个一万行的单行文件不仅是编译风险还会让 review 变成灾难。5.3 把编译栈边界纳入 CI 回归测试根治的最后一步是让这类问题在 CI 里以可预期的方式暴露而不是等用户走到某个极端输入才爆炸。可以做两件事第一件在构建脚本里保留一个「带小栈的编译冒烟任务」。比如把默认编译栈设置成 512KB跑一组包含最大深度压力的样例。如果这组样例在极小栈下都能编译通过说明代码形态处于安全范围一旦未来某天生成器输出变深立即在 CI 上崩给你看而不是等到生产发布前才爆。第二件生成器里加深度指标上报。每次生成结束后把最大 AST 深度写进构建日志。你会很快积累出「哪个模块深度增长异常」的数据问题在爆发前就有预警。5.4 一张自检清单最后给一张我在项目里用过的自检清单出现编译期 StackOverflowError 时逐项对照崩溃发生在解析阶段检查括号嵌套、表达式链、字符串拼接的超长表达式。崩溃发生在类型检查阶段检查泛型嵌套、通配符嵌套、链式调用与重载解析。崩溃发生在 Enter/Lower 阶段检查继承层级、匿名类嵌套、内部类链。代码里有自动生成源文件优先检查生成器的递归深度而不是手工代码。换一个 JDK 版本后不崩了记录好版本差异但仍需定位代码形态问题。调大 -J-Xss 后能过只当临时方案24 小时内必须补上根因分析。我在实际项目中试过很多次最危险的情况不是「手工代码写得很深」而是「生成器现在不深但输入数据可以无限深」。所以要根治永远要在生成侧加限制而不是在构建侧加栈。这是我和这个错误打了这么多次交道以后最想强调的一点调大栈解决的是「今天的崩溃」生成器加深度阈值解决的是「未来一百次的崩溃」两者都要做但后者的价值高得多。