Jenkins使用maven surefire时单个测试失败如何标记为不稳定

核心问题根因 #

按照Jenkins的状态判定规则：

若构建整体执行成功，但有一个或多个发布器上报不稳定状态，该构建即被判定为不稳定。例如配置了JUnit发布器时，若存在测试用例执行失败，构建就会被标记为不稳定状态。

但当前配置下根本走不到这个判定环节，问题出在两个层面：

• 当前maven-surefire-plugin配置的<testFailureIgnore>false</testFailureIgnore>规则，会在出现测试用例执行失败时，直接中断Maven构建进程，返回非0退出码给Jenkins主进程。
• Jenkins对构建状态的判定优先级是：只要执行的构建进程返回非0退出码，会直接将构建标记为失败，不会进入后续的测试报告解析、发布器状态上报环节。
• 你配置的ReportNG组件里带的JUnitXMLReporter虽然会生成符合Jenkins JUnit插件解析规范的测试XML报告，但因为进程提前返回非0码被终止，Jenkins根本没有机会走到解析报告、判定不稳定状态的步骤。

具体配置调整 #

1. 修改surefire插件的测试失败拦截配置 #

将原有配置里的testFailureIgnore参数值从false调整为true：

<testFailureIgnore>true</testFailureIgnore>

调整后逻辑：即使存在测试用例执行失败，Maven构建流程也不会提前中断，会正常走完所有测试执行、报告生成环节，最终向Jenkins返回正常的0退出码，让流程进入Jenkins的发布器判定环节。

2. 补全Jenkins任务的JUnit报告发布配置 #

• 打开对应Jenkins任务的配置页面，在「构建后操作」板块添加Publish JUnit test result report步骤。
• 测试报告路径填写ReportNG生成XML报告的匹配规则，常规路径为target/surefire-reports/*.xml。
• 可根据团队规则配置对应阈值：比如设置测试失败率超过多少才标记为失败、低于阈值就标记为不稳定，默认配置下只要存在测试用例失败，就会将构建标记为不稳定状态。

注意事项 #

• 开启testFailureIgnore=true不会模糊构建失败的判定边界：如果是代码编译错误、依赖缺失、类加载失败这类和测试用例执行结果无关的问题，Maven依然会返回非0退出码，正常触发Jenkins构建失败，不会把非测试类的报错错误归类为不稳定状态。
• 你当前使用的ReportNG的JUnitXMLReporter输出的报告格式完全兼容Jenkins的JUnit发布器，不需要额外替换报告组件，只要打通了流程提前中断的问题，就能实现预期的「单个测试用例失败就标记构建为不稳定」的效果。

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