如何在Jenkins中动态修改SonarQube项目版本号？已尝试方案无效

我来帮你搞定这个动态版本号的问题——之前我也踩过同样的坑，核心原因是你搞混了配置的解析主体：直接写在sonar.properties里的占位符，SonarQube本身不会解析它们，得让Gradle或者Jenkins来处理替换才行。下面是两种可行的解决方案：

方案1：在Gradle构建脚本中配置（推荐） #

SonarQube Scanner for Gradle的正确姿势是把Sonar属性直接写在build.gradle里，这样Gradle会自动解析占位符和环境变量。

步骤： #

1. 确保你的build.gradle已经引入了SonarQube插件：

   plugins {
       id 'org.sonarqube' version '3.5.0.2730' // 建议使用最新稳定版本
   }
   

2. 在脚本中添加Sonar配置块，动态设置版本号：

   sonarqube {
       properties {
           // 必填元数据
           property 'sonar.projectKey', 'myproject'
           property 'sonar.projectName', 'myproject'
           // 方式A：使用Gradle项目版本
           property 'sonar.projectVersion', project.version
           // 方式B：使用Jenkins环境变量（优先用环境变量， fallback到项目版本）
           // property 'sonar.projectVersion', System.getenv('APP_BUILD_NUMBER') ?: project.version
           property 'sonar.sourceEncoding', 'UTF-8'
           // 补充你的路径配置（比如sonar.sources等）
       }
   }
   

   这样执行gradle sonarqube任务时，Gradle会自动把project.version或者环境变量APP_BUILD_NUMBER替换成实际值，传到SonarQube。

方案2：用Jenkins插件预处理sonar.properties #

如果你坚持要使用单独的sonar.properties文件，可以让Jenkins在扫描前先替换文件里的占位符：

1. 安装Jenkins的Replace Tokens插件；
2. 在Jenkins任务中添加「Replace Tokens」构建步骤：
   • 指定要处理的文件路径：比如sonar.properties
   • 保持默认的Token前缀${和后缀}（或者根据你的配置调整）
3. 确保Jenkins任务中已经正确设置了APP_BUILD_NUMBER环境变量（比如通过构建参数、流水线变量传递）；
4. 最后再执行Gradle的Sonar扫描任务。

这样Jenkins会先把sonar.projectVersion=${APP_BUILD_NUMBER}里的占位符替换成实际的构建号，再让Sonar读取配置。

关键注意事项 #

• 不要直接在sonar.properties里写${project.version}或${APP_BUILD_NUMBER}——SonarQube不会解析这些占位符，只会把它们当作字符串直接显示；
• 如果用环境变量，一定要确认Jenkins任务中该变量已正确传递（比如在流水线里用environment { APP_BUILD_NUMBER = currentBuild.number }）；
• 优先用方案1，因为Gradle脚本的方式更可控，也符合SonarQube Scanner for Gradle的官方设计逻辑。

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