Maven site阶段测试失败但构建仍通过的问题解决咨询

我之前也碰到过一模一样的场景，核心卡点在于Maven的阶段执行逻辑：如果前面的阶段（比如install包含的test）失败，后续的site阶段就会直接被跳过，根本没机会生成报告。要实现「执行所有测试→生成报告→构建失败」的完整流程，得从插件配置和命令执行顺序两方面调整，下面是具体的可行方案：

方案一：通过Pom配置实现单命令完成（推荐） #

1. 配置Surefire插件，允许测试失败但继续执行 #

先修改pom.xml里的maven-surefire-plugin，开启测试失败不终止的开关，这样即使测试用例失败，Maven也会跑完所有测试并继续执行后续阶段：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <version>3.2.5</version>
      <configuration>
        <!-- 测试失败时不中断构建，继续执行后续步骤 -->
        <testFailureIgnore>true</testFailureIgnore>
        <!-- 避免没有测试类时触发构建失败 -->
        <failIfNoTests>false</failIfNoTests>
      </configuration>
    </plugin>

2. 添加测试结果检查，在生成报告后终止构建 #

接下来需要在site报告生成完成后，检查测试是否真的失败，若失败则让构建最终终止。这里用gmavenplus-plugin写一段Groovy脚本解析Surefire生成的XML测试报告：

<plugin>
      <groupId>org.codehaus.gmavenplus</groupId>
      <artifactId>gmavenplus-plugin</artifactId>
      <version>1.13.1</version>
      <executions>
        <execution>
          <id>check-test-failures</id>
          <!-- 把检查步骤放在site阶段之后，确保报告已经生成 -->
          <phase>site</phase>
          <goals>
            <goal>execute</goal>
          </goals>
          <configuration>
            <scripts>
              <script><![CDATA[
                import groovy.xml.XmlSlurper

                def reportsDir = new File(project.build.directory, "surefire-reports")
                boolean hasFailures = false

                // 遍历所有Surefire生成的XML测试报告
                reportsDir.eachFileMatch(~/.+\.xml/) { reportFile ->
                  def testResult = new XmlSlurper().parse(reportFile)
                  def failureCount = testResult.@failures.toInteger()
                  def errorCount = testResult.@errors.toInteger()

                  if (failureCount > 0 || errorCount > 0) {
                    hasFailures = true
                    println "⚠️ 测试报告 ${reportFile.name} 存在失败: 失败数=${failureCount}, 错误数=${errorCount}"
                  }
                }

                // 如果有测试失败，抛出异常终止构建
                if (hasFailures) {
                  throw new RuntimeException("❌ 存在测试失败，构建终止")
                }
              ]]></script>
            </scripts>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

3. 执行命令 #

现在只需要运行这条命令即可：

mvn clean test site

完整流程是：

• 执行所有测试用例（失败但不终止）
• 生成Site格式的测试报告
• 检查测试结果，若有失败则抛出异常，让构建最终失败

方案二：分命令执行（适合快速验证） #

如果不想修改Pom配置，可以用Shell命令分三步执行（依赖Linux/macOS的Shell环境）：

# 1. 执行所有测试，允许失败但跑完所有模块（-fae）
mvn test -fae
# 2. 生成Site报告
mvn site
# 3. 检查测试报告，若存在失败则终止构建
if [ $(grep -r "failure" target/surefire-reports/ | wc -l) -gt 0 ]; then exit 1; fi

这个方法无需修改配置，但跨平台性稍差，适合临时验证场景。

为什么-fae参数对你无效？ #

-fae（Fail at End）的作用是多模块项目中，某个模块失败后继续执行其他模块，最后再整体标记失败。但你的场景是mvn install site：install阶段包含test，一旦test失败，install阶段直接标记失败，后续的site阶段根本不会被触发，所以-fae无法解决这个问题。

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