JS测试失败时如何将Jenkins构建标记为失败而非不稳定

我来帮你搞定这个需求——要让单元测试失败时直接把构建标成红色的Failed而不是黄色的Unstable，咱们主要要调整两个地方：一是确保测试失败时触发流水线的失败逻辑，二是修正你现有代码里的GitLab状态更新逻辑。

问题分析 #

当前你的流水线里，测试失败后Jenkins默认标记为Unstable，大概率是因为：

• 测试框架（比如Jest）在测试失败时返回了0的退出码（有些非CI模式下会这样），导致Jenkins认为步骤没失败；
• 你的try-catch块没有处理测试失败的情况，也没主动标记构建状态；
• 现有gitStatus函数的逻辑有问题，不管构建成功与否都会执行失败状态的更新。

具体修改方案 #

1. 强制测试失败时返回非零退出码

对于Jest来说，加上--ci参数就能让它在测试失败时返回非零退出码，这样Jenkins的sh步骤会直接识别为失败：

sh 'npm run test -- --ci'

如果你的npm脚本已经包含了必要参数，也可以用下面的方式强制捕获失败：

sh '''
#!/bin/bash
npm run test
if [ $? -ne 0 ]; then
  exit 1
fi
'''

2. 调整try-catch逻辑，主动标记构建失败

在测试阶段的外部catch块里，主动设置构建结果为FAILURE，并且抛出异常终止流水线，这样构建就会变成红色失败状态。

3. 修复GitLab状态更新函数

原来的gitStatus函数不管buildStatus是不是SUCCESS，都会执行失败状态的更新，需要用else分支来区分成功/失败的处理逻辑。

修改后的完整流水线代码 #

def gitStatus(buildStatus) {
    if (buildStatus == 'SUCCESS') {
        updateGitlabCommitStatus(name: 'build', state: 'success')
        addGitLabMRComment comment: 'Build Passed'
    } else {
        updateGitlabCommitStatus(name: 'build', state: 'failed')
        addGitLabMRComment comment: "Something unexpected happened. Inspect Jenkins logs."
        emailext subject: '$DEFAULT_SUBJECT', body: '$DEFAULT_CONTENT', to: ''
    }
}

try {
    node ('Builder_1') {
        stage('Preparing source tree') {
            // 这里放你的源码拉取等逻辑
        }
        stage('Install Dependencies') {
            sh '''#!/bin/bash
                npm install --prefer-offline
            '''
        }
        stage ('Run Tests') {
            withEnv(["JEST_JUNIT_OUTPUT=./jest-test-results.xml"]) {
                // 用--ci参数确保测试失败时返回非零退出码
                sh 'npm run test -- --ci'
            }
        }
        // 测试成功后标记GitLab状态为成功
        gitStatus('SUCCESS')
    }
} catch (Exception e) {
    // 捕获任何异常，标记构建为失败
    currentBuild.result = 'FAILURE'
    gitStatus('FAILURE')
    // 抛出异常确保流水线终止并标记为失败
    throw e
}

关键说明 #

• 移除了测试阶段多余的嵌套try块，让整个流水线的异常统一在外部catch处理；
• 在catch块里设置currentBuild.result = 'FAILURE'，直接强制构建状态为失败；
• 修正了gitStatus函数的分支逻辑，确保成功和失败状态不会同时执行；
• 给Jest加上--ci参数，确保测试失败时返回非零退出码，触发流水线的失败流程。

这样调整后，只要单元测试失败，流水线就会直接标记为红色的Failed，同时正确更新GitLab的提交状态和发送通知。

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