CI/CD / 系统课时

测试失败时立即阻断构建

测试失败时立即阻断构建

自动测试只有真正影响流水线状态,才能成为质量门禁。本节把测试阶段接入 Jenkins Pipeline:测试命令一旦失败就停止后续制品发布或部署,同时保留测试报告,让失败原因能够在 Jenkins 中继续定位。

学习目标

  • 让自动测试失败正确转化为流水线失败
  • 阻止测试未通过的版本进入后续发布阶段
  • 在阻断流水线的同时保留可分析的测试结果

把测试放在发布动作之前

质量门禁的关键不是“执行过测试”,而是后续动作依赖测试成功。典型顺序是构建、测试、制品处理或部署;只要测试阶段失败,后续普通 Stage 就不应继续执行。

测试门禁阻断流水线示意图

下面以 Maven 项目为例。测试阶段直接运行 ./mvnw test,不使用忽略失败的参数。只要 Maven 因测试失败返回非零退出码,sh 步骤就失败,Declarative Pipeline 不会继续执行后面的 Package Stage。

groovy
pipeline {
    agent any

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Test') {
            steps {
                sh 'chmod +x mvnw'
                // 测试失败必须保留非零退出码,让 Jenkins 阻断后续阶段
                sh './mvnw --batch-mode test'
            }
            post {
                always {
                    junit testResults: 'target/surefire-reports/*.xml', allowEmptyResults: true
                }
            }
        }

        stage('Package') {
            steps {
                sh './mvnw --batch-mode package -DskipTests'
            }
        }
    }
}

预期结果

text
测试全部通过:Test 成功,随后执行 Package。
存在失败测试:Test 失败,Package 不执行,流水线最终为失败状态。

Maven 的详细输出会因项目和测试用例不同而变化,因此验证重点是 Stage 与最终流水线状态,而不是某一条固定日志。

为什么报告收集放在 post 中

如果把 junit 写在失败的测试命令之后,测试命令抛出错误时,普通步骤可能没有机会继续执行。将报告收集放到 Stage 的 post { always { ... } } 中,可以让测试成功或失败后都尝试发布 JUnit XML 报告。

这里的 allowEmptyResults: true 适合示例和渐进接入场景,因为测试进程可能在生成报告前就异常退出。如果项目要求“没有测试报告本身就是质量问题”,则不应放宽这一条件,应让报告缺失也暴露为异常。

不要把失败测试伪装成成功

为了“让流水线跑完”而吞掉测试失败,会直接破坏质量门禁。例如下面这些处理都需要格外警惕:Shell 命令后追加 || true、捕获退出码后始终返回成功,或者给 Maven 配置忽略测试失败。

如果业务确实要求测试失败后执行清理、通知或报告收集,应使用 post 处理这些收尾动作,而不是让主测试步骤假装成功。这样既能保留诊断信息,又不会让后续发布阶段误认为版本已经通过验证。

验证门禁是否真的生效

最可靠的验收方式是准备一个确定失败的测试,在非生产分支运行一次流水线,观察测试 Stage 和后续 Stage 的状态。随后修复测试并再次执行,确认流水线能够正常通过。

验收时应同时满足三个条件:失败测试使 Test Stage 失败;Package 或部署等后续普通 Stage 被跳过;测试报告仍可用于定位失败用例。三者同时成立,才说明测试不仅被“执行”,而是真正成为了流水线的质量门禁。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

测试失败时立即阻断构建

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通