Jenkins运行Cucumber JVM测试偶发无报错中断、报告记录缺失问题求助

安全阿岳

2026-9-30

可能的问题原因

系统资源不足触发OOM Kill：Jenkins agent节点的CPU、内存不足以支撑10个并发fork进程运行测试，系统自带的OOM Killer会随机选中占用资源高的测试进程强制终止，这种情况下进程来不及输出异常堆栈、写入Cucumber结果文件，所以无任何报错信息。
并行测试资源竞争：多个fork进程共用同一套测试资源（如数据库实例、缓存、mock服务端口、临时文件目录）时，可能出现死锁、资源占满的情况，导致对应进程挂起，最终被Jenkins的stage超时机制主动终止，无日志输出。
构建工具的并行配置缺陷：如果你使用Maven Surefire/Gradle Test执行测试，fork相关的参数配置错误（比如reuseForks=true带来的进程状态残留，或者子进程退出码未被父进程捕获），会导致子进程异常退出时父进程未识别到错误，直接继续执行后续流程。
缓冲区未刷入磁盘：JVM的标准输出、错误输出以及Cucumber的结果写入逻辑都带有缓冲区，进程被强制终止时缓冲区内容未flush到磁盘，所以不会留下任何报错、警告记录，结果文件也不会生成。
Jenkins agent节点不稳定：测试执行过程中agent节点临时断连、磁盘占满，刚好对应正在执行的fork进程被中断，日志和结果无法回传到Jenkins master节点。

排查与解决方案

首先增加日志配置定位根因：
- 测试执行命令添加调试参数，Maven添加-X，Gradle添加--info，同时给Cucumber启动参数加上--verbose，打印每个feature的启动、结束标记。
- 给测试进程添加JVM参数：-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=./heap-dumps/ -XX:+ExitOnOutOfMemoryError -Xloggc:./gc-logs/gc-%t.log，每个fork进程生成独立的GC日志和堆转储文件，确认是否存在JVM层面的内存溢出。
- 检查Jenkins agent的系统日志（Linux下查看/var/log/syslog），搜索OOM、kill process关键字，确认是否有测试进程被系统强制终止。

调整并行测试配置：

如果使用Maven Surefire插件，参考配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.1.2</version>
  <configuration>
    <forkCount>10</forkCount>
    <reuseForks>false</reuseForks>
    <printSummary>true</printSummary>
    <testFailureIgnore>false</testFailureIgnore>
  </configuration>
</plugin>

暂时调低fork数量到5，验证问题是否复现，如果消失则确认是资源不足导致，可升级agent配置或者保留低fork数运行。

优化测试资源隔离：每个fork进程分配独立的测试资源，比如数据库用独立schema、mock服务用动态端口、临时文件目录按进程ID区分，避免资源竞争导致的进程挂死。
添加结果校验逻辑：构建步骤最后增加shell脚本，统计总feature文件数和已生成的Cucumber json结果数，如果数量不一致直接标记构建失败，输出缺失的feature名称，缩小排查范围。

内容的提问来源于stack exchange，提问作者Nils