Newman执行Postman集合生成htmlextra报告后Jenkins构建失败求助

快速修复方案 #

直接修改Windows批处理命令，在末尾添加|| exit 0，强制让命令返回0退出码（Jenkins识别为构建成功）：

newman run Library.postman_collection.json -d TestData.csv -e QA.postman_environment.json -g workspace.postman_globals.json -r htmlextra || exit 0

问题根因 #

Newman的退出码规则导致了这个现象：

• 当Postman集合中存在测试用例失败时，Newman会返回非0的退出码
• Jenkins默认通过命令的退出码判断构建状态，非0则直接标记为失败
  即使htmlextra报告已生成（说明集合执行完成），只要有测试用例失败，Jenkins就会触发失败标记。

更灵活的处理方式 #

1. 允许构建失败但标记为成功/不稳定 #

在Jenkins的「Execute Windows batch command」构建步骤中：

• 点击「Advanced」展开高级设置
• 勾选「Allow failure」选项
• 可在下方「Failure condition」中设置，比如选择「Mark build as unstable」，这样测试失败时构建标记为不稳定而非失败，同时保留完整执行记录。

2. 区分执行错误和测试失败 #

如果需要忽略测试失败，但捕捉真正的执行错误（比如文件找不到、环境配置错误），可以配合Newman的json报告器编写判断脚本：

@echo off
REM 运行Newman并生成json格式报告
newman run Library.postman_collection.json -d TestData.csv -e QA.postman_environment.json -g workspace.postman_globals.json -r htmlextra,json --reporter-json-export newman-report.json

REM Newman退出码规则：1=测试用例失败，其他值=执行错误（如文件缺失）
if %errorlevel% equ 1 (
    REM 仅测试失败时，强制返回0让Jenkins标记构建成功
    exit 0
) else (
    REM 其他执行错误，返回原退出码让Jenkins标记失败
    exit %errorlevel%
)

注：若需要更精准判断，可借助jq工具解析newman-report.json中的run.failures字段，进一步区分失败类型。

3. 结合Jenkins JUnit插件展示测试结果 #

使用Newman的JUnit报告器生成测试报告，让Jenkins解析并展示测试详情，同时自主控制构建状态：

1. 修改Newman命令添加JUnit报告器：

newman run Library.postman_collection.json -d TestData.csv -e QA.postman_environment.json -g workspace.postman_globals.json -r htmlextra,junit --reporter-junit-export newman-junit.xml

2. 在Jenkins中添加「Publish JUnit test result report」步骤，指定newman-junit.xml文件路径
3. 在该步骤的「Health report thresholds」中设置阈值，比如将「Failed tests」的阈值设为大于集合内总用例数，这样即使有测试失败，构建仍会被标记为成功。

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