Jenkins流水线超时无法捕获FlowInterruptedException致任务不终止如何解决

根因说明 #

你遇到的问题本质是mocha 9+并行执行模式的信号处理逻辑与Jenkins timeout步骤的中断逻辑冲突：

• Jenkins timeout触发时会先给shell进程发送SIGTERM信号
• mocha并行模式的worker池收到SIGTERM后不会直接退出，而是将信号转换为测试异常，返回非0退出码
• sh步骤先抛出执行失败异常，覆盖了原本应该抛出的FlowInterruptedException，导致你无法捕获超时中断，任务无法正常终止

可选落地方法 #

• 方案1：禁用mocha并行执行（成本最低） #

  该问题仅在mocha开启--parallel参数时触发，如果测试场景对执行速度要求不高，直接去掉测试脚本中的并行参数即可恢复默认信号处理逻辑，超时后mocha会随SIGTERM直接退出，Jenkins可以正常触发任务终止。

• 方案2：调整timeout配置，强制短时间内强杀进程 #

  给timeout步骤添加forceKillAfter参数，发送SIGTERM后等待指定时长直接发送SIGKILL强杀所有关联进程，不给mocha抛出测试异常的时间。修改后的代码示例如下：

  pipeline {
      agent any
      stages {
          stage("run-tests") {
              steps {
                  script {
                      try {
                          // 60秒超时，发SIGTERM后5秒未退出直接发SIGKILL
                          timeout(time: 60, unit: 'SECONDS', forceKillAfter: 5) {
                               sh "npm run mocha-tests"
                          }
                      } catch (org.jenkinsci.plugins.workflow.steps.FlowInterruptedException e) {
                          echo "interrupt ${e.toString()}"
                          // 捕获后必须重新抛出异常才能终止任务
                          throw e
                      } catch (Throwable e) {
                          echo "regular ${e.toString()}"
                          // 非超时异常可按需选择继续执行或终止
                          throw e
                      }
                  }
              }
          }
      }
  }
  

• 方案3：封装npm测试脚本，拦截SIGTERM直接终止进程 #

  修改package.json中的mocha-tests脚本，添加信号处理逻辑，收到SIGTERM时直接强杀所有mocha进程，不返回测试错误：

  {
    "scripts": {
      "mocha-tests": "trap 'kill -9 $$' SIGTERM; mocha --parallel 你的其他测试参数"
    }
  }
  

• 方案4：调整sh步骤返回状态码，主动判断超时 #

  让sh步骤不直接抛出异常，而是返回执行状态码，超时后你可以主动识别中断场景，手动终止任务。

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