CI/CD / 系统课时
测试失败时立即阻断构建
测试失败时立即阻断构建
自动测试只有真正影响流水线状态,才能成为质量门禁。本节把测试阶段接入 Jenkins Pipeline:测试命令一旦失败就停止后续制品发布或部署,同时保留测试报告,让失败原因能够在 Jenkins 中继续定位。
学习目标
- 让自动测试失败正确转化为流水线失败
- 阻止测试未通过的版本进入后续发布阶段
- 在阻断流水线的同时保留可分析的测试结果
把测试放在发布动作之前
质量门禁的关键不是“执行过测试”,而是后续动作依赖测试成功。典型顺序是构建、测试、制品处理或部署;只要测试阶段失败,后续普通 Stage 就不应继续执行。

下面以 Maven 项目为例。测试阶段直接运行 ./mvnw test,不使用忽略失败的参数。只要 Maven 因测试失败返回非零退出码,sh 步骤就失败,Declarative Pipeline 不会继续执行后面的 Package Stage。
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'
}
}
}
}预期结果
测试全部通过: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 被跳过;测试报告仍可用于定位失败用例。三者同时成立,才说明测试不仅被“执行”,而是真正成为了流水线的质量门禁。