如何在TeamCity中执行Sonar？多步骤Maven构建偶发失败求助

这种时好时坏的构建失败确实让人抓狂，结合你给出的步骤和模糊错误信息，咱们来拆解可能的原因和对应的解决方案：

先分析当前流程的潜在隐患 #

你现在的步骤顺序是Maven clean deploy -DskipITs → Maven verify → Maven sonar:sonar，这里有几个容易触发偶发问题的点：

• 构建状态不一致：deploy会把产物上传到仓库，但后续的verify又会重新执行测试、校验逻辑，在TeamCity共享工作目录的环境下，可能出现文件锁定、临时文件残留等偶发的文件系统冲突，导致Sonar扫描读取文件失败。
• 依赖的报告文件不稳定：Sonar扫描依赖verify阶段生成的测试报告、覆盖率报告等，如果verify步骤偶发出现报告生成不完整（比如测试用例超时、磁盘IO异常），就会触发Sonar插件的模糊错误。
• 资源竞争：连续执行三个Maven任务会消耗大量JVM内存，TeamCity代理资源不足时，Sonar扫描（本身比较耗资源）可能偶发出现内存溢出，导致无明确原因的失败。

具体解决方案 #

1. 调整构建步骤顺序（最关键） #

把流程改成先校验、再部署、最后扫描的逻辑，避免状态混乱：

• 第一步：Maven clean verify —— 先完成所有编译、测试、校验工作，确保产物和报告都稳定生成
• 第二步：Maven deploy -DskipITs —— 基于验证通过的产物执行部署
• 第三步：Maven sonar:sonar —— 基于稳定的verify产物执行Sonar扫描

或者更简洁的方式：把Sonar扫描绑定到verify阶段，在项目的pom.xml中添加配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.sonarsource.scanner.maven</groupId>
      <artifactId>sonar-maven-plugin</artifactId>
      <version>3.4.0.905</version>
      <executions>
        <execution>
          <phase>verify</phase>
          <goals>
            <goal>sonar</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

这样只需要两个步骤：Maven clean verify（自动触发Sonar扫描）→ Maven deploy -DskipITs，减少步骤间的状态不一致问题。

2. 给Sonar步骤添加明确的上下文参数 #

在TeamCity的Sonar步骤中，给Maven命令添加以下参数，确保Sonar扫描使用明确的项目目录和独立的构建上下文：

-Dsonar.projectBaseDir=%teamcity.build.checkoutDir% -Dmaven.reactor.failFast=false

3. 提升Sonar步骤的资源配置 #

Sonar扫描比较吃内存，给该步骤的Maven命令添加JVM参数，避免内存溢出：

• 对于Java 8及以下：-Xmx1G -XX:MaxPermSize=256M
• 对于Java 9+：-Xmx1G

4. 开启详细日志定位偶发问题 #

当失败发生时，在Sonar步骤的Maven命令中添加-X参数，获取完整的调试日志，这样就能看到错误的具体原因（比如某个报告文件缺失、SonarQube服务器连接超时、依赖下载失败等），方便精准排查。

5. 确保工作目录干净 #

在TeamCity构建配置中开启“清理构建目录”选项，或者在Sonar步骤前添加一个简单的校验步骤，比如Linux下执行ls -la target/surefire-reports/，Windows下执行dir target\surefire-reports，如果发现报告目录为空或异常，直接终止构建，避免Sonar扫描无意义地失败。

内容的提问来源于stack exchange，提问作者Stefan S.