Newman执行Postman集合断言失败，Jenkins未设为不稳定状态的解决方法

先搞懂核心原因 #

Newman的退出码规则是：

• 0：所有测试通过
• 1：出现一般性错误（比如集合文件不存在、环境变量配置错误）
• 2：断言失败，但集合执行流程完成

Jenkins默认只把退出码1及其他非0值（除特殊场景）判定为构建失败，而退出码2会被当成“执行成功”，所以我们需要手动拦截这个退出码，把它映射为Jenkins的“不稳定”状态。

方法一：Freestyle项目配置 #

如果你用的是传统Freestyle项目，可以按以下步骤配置：

1. 添加执行Newman的Shell步骤 #

在构建步骤里选择「Execute shell」，输入以下脚本：

# 执行Newman测试，保存退出码
newman run your-collection.json -e your-environment.json
EXIT_CODE=$?

# 将退出码写入环境变量文件，供后续步骤调用
echo "EXIT_CODE=${EXIT_CODE}" > ${WORKSPACE}/newman-results.properties

# 仅非2的错误直接触发构建失败，断言失败的情况交给后续步骤处理
if [ $EXIT_CODE -ne 2 ] && [ $EXIT_CODE -ne 0 ]; then
  exit $EXIT_CODE
fi

记得把your-collection.json和your-environment.json替换成你实际的文件路径。

2. 注入环境变量 #

添加一个「Inject environment variables」步骤，在「Properties File Path」中填入newman-results.properties，让后续步骤能读取到EXIT_CODE变量。

3. 用Groovy脚本设置构建状态 #

先确保你安装了「Groovy Postbuild」插件，然后添加「Groovy Postbuild」的Post-build Action，输入以下脚本：

def exitCode = manager.build.getEnvironment(null).get('EXIT_CODE')
if (exitCode == '2') {
  // 设置构建为不稳定状态
  manager.build.setResult(hudson.model.Result.UNSTABLE)
  // 添加构建摘要提示，方便快速识别问题
  manager.createSummary('warning.png').appendText('<h3>Newman断言失败！构建已标记为不稳定</h3>', false, false, false, 'orange')
}

方法二：Pipeline项目配置 #

如果你用的是Jenkins Pipeline（更灵活，推荐使用），可以直接在Jenkinsfile里处理退出码：

pipeline {
  agent any
  stages {
    stage('Run Newman Tests') {
      steps {
        script {
          // 执行Newman并获取退出码，returnStatus: true表示不直接让构建失败
          def newmanExitCode = sh returnStatus: true, script: '''
            newman run your-collection.json -e your-environment.json
          '''
          
          // 根据退出码判断并设置构建状态
          switch(newmanExitCode) {
            case 0:
              echo "✅ 所有Newman测试断言通过！"
              break
            case 2:
              echo "⚠️ Newman断言失败，构建标记为不稳定"
              currentBuild.result = 'UNSTABLE'
              break
            default:
              error "❌ Newman执行出错，退出码：${newmanExitCode}"
          }
        }
      }
    }
  }
}

这个方式不需要额外安装插件，直接通过Pipeline脚本就能完成状态控制，非常简洁。

验证配置 #

配置完成后触发一次构建：

• 所有断言通过：构建显示「Success」（蓝色图标）
• 断言失败：构建显示「Unstable」（黄色图标）
• 出现其他执行错误：构建显示「Failed」（红色图标）

这样就完全符合你的需求啦！

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