如何通过Maven在TeamCity任务中读取Pom版本并设置自定义构建编号？

我之前也碰到过一模一样的情况——本地跑Maven命令能正常输出TeamCity的buildNumber指令，但放到TeamCity代理上就没效果了。结合你的场景，咱们一步步来排查和解决：

核心问题分析 #

本地和TeamCity环境的差异主要集中在这几点：

• TeamCity代理的shell环境变量、Maven日志级别可能会拦截或过滤输出
• TeamCity的构建参数（比如%build.counter%）需要正确传递到Maven上下文
• exec插件的输出可能没被TeamCity的服务消息捕获机制识别

正确配置Maven插件组合 #

给你一个经过验证的pom.xml配置，用build-helper:parse-version解析版本，再用exec:exec输出TeamCity服务消息：

<build>
  <plugins>
    <!-- 解析pom.xml中的版本号 -->
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>build-helper-maven-plugin</artifactId>
      <version>3.3.0</version>
      <executions>
        <execution>
          <id>parse-project-version</id>
          <phase>validate</phase>
          <goals>
            <goal>parse-version</goal>
          </goals>
        </execution>
      </executions>
    </plugin>

    <!-- 输出TeamCity buildNumber服务消息 -->
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>exec-maven-plugin</artifactId>
      <version>3.1.0</version>
      <executions>
        <execution>
          <id>set-teamcity-build-number</id>
          <phase>validate</phase>
          <goals>
            <goal>exec</goal>
          </goals>
          <configuration>
            <executable>echo</executable>
            <!-- 组合版本号：去掉SNAPSHOT，替换为TeamCity构建计数器 -->
            <arguments>
              <argument>##teamcity[buildNumber '${parsedVersion.majorVersion}.${parsedVersion.minorVersion}.${parsedVersion.incrementalVersion}-${build.counter}']</argument>
            </arguments>
            <!-- 确保输出到标准输出，避免被TeamCity忽略 -->
            <outputDirectory>.</outputDirectory>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

关键配置步骤 #

1. 传递TeamCity构建计数器到Maven
   在TeamCity的Maven构建步骤中，执行命令要加上-Dbuild.counter=%build.counter%，比如：

   mvn validate -Dbuild.counter=%build.counter%
   

   这样TeamCity的%build.counter%参数会被替换成实际的构建次数，传递到Maven的上下文里。

2. 确保TeamCity捕获服务消息

   • 检查TeamCity构建日志，确认是否有输出##teamcity[buildNumber 'xxx']这条消息。如果没有，调整Maven的日志级别为INFO（TeamCity默认可能是WARN，会过滤掉插件的INFO输出）。
   • 确保exec插件的输出是到标准输出，而不是错误输出。上面的配置已经默认处理了，但如果还是有问题，可以添加<redirectOutput>false</redirectOutput>到exec插件的configuration里。

替代方案：用脚本直接解析pom #

如果Maven插件的方式还是有问题，可以换用TeamCity的脚本构建步骤（Bash/PowerShell），直接解析pom.xml版本并输出服务消息：

Bash版本： #

# 从pom.xml读取版本号
RAW_VERSION=$(xmllint --xpath '/project/version/text()' pom.xml)
# 替换SNAPSHOT为构建计数器
NEW_VERSION=${RAW_VERSION/-SNAPSHOT/-%build.counter%}
# 输出TeamCity服务消息
echo "##teamcity[buildNumber '$NEW_VERSION']"

PowerShell版本： #

$pomContent = Get-Content pom.xml -Raw
$rawVersion = [regex]::Match($pomContent, '<version>(.*?)</version>').Groups[1].Value
$newVersion = $rawVersion -replace '-SNAPSHOT', "-%build.counter%"
Write-Host "##teamcity[buildNumber '$newVersion']"

排查小技巧 #

• 在TeamCity构建日志中搜索buildNumber，确认服务消息是否被输出
• 本地模拟TeamCity环境：手动传递-Dbuild.counter=123参数跑Maven命令，看输出是否符合预期
• 检查插件版本：用最新版的build-helper-maven-plugin和exec-maven-plugin，避免旧版本的兼容性问题

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