JMeter的Response Assertion失败时如何设置Jenkins构建为失败状态

核心原因说明 #

默认JMeter运行时即便存在断言失败，也会返回0的进程退出码，而Jenkins默认判断任务执行成功的依据就是执行命令返回的退出码是否为0，所以才会出现断言失败但构建仍显示成功的问题。

具体配置步骤 #

1. 调整JMeter运行参数，开启失败返回非0退出码 #

运行JMeter测试命令时增加-e参数，该参数会触发JMeter在检测到断言失败、请求错误时自动返回非0的退出码：

jmeter -n -t 你的测试脚本文件名.jmx -l 测试结果文件名.jtl -e

如果需要永久生效，也可以修改JMeter配置：

• 打开JMeter安装路径下bin/jmeter.properties文件
• 修改配置项jmeter.exit.check.pause=2000，确保JMeter退出前完成所有结果统计
• 开启jmeter.save.saveservice.assertion_results_failure_message=true，保存断言失败详情到结果文件

2. 调整Jenkins任务配置，识别JMeter返回的退出码 #

• 自由风格任务：在「执行shell」或「执行Windows批处理命令」步骤中直接运行带-e参数的JMeter命令即可，注意不要在命令末尾加|| true这类强制返回0的语句，会覆盖JMeter的错误退出码
• Pipeline任务：直接在步骤中调用JMeter命令即可，非0退出码会自动触发构建失败，示例代码：

  stage('执行JMeter接口测试') {
      steps {
          sh 'jmeter -n -t apitest.jmx -l result.jtl -e'
      }
  }
  

可选：精细化控制失败阈值 #

如果需要支持自定义错误率阈值（比如允许1%以内的请求失败），可以配合Jenkins的Performance插件实现：

• 安装Performance插件后，在构建后步骤添加「Publish Performance test result report」
• 选择JMeter格式，填写生成的jtl结果文件路径
• 在「Error thresholds」配置项中设置允许的最大错误率，当实际错误率超过阈值时就会标记构建失败

内容的提问来源于stack exchange，提问作者QA-Palash