Jenkins工具“提取归档的子目录”作用及SonarQube Scanner PATH配置问题

• 先检查全局工具配置的核心选项
  进入Jenkins的「Manage Jenkins」→「Global Tool Configuration」，找到SonarQube Scanner的配置项：

  1. 确认已勾选「Install automatically」，同时务必勾选「Add this tool to the system PATH」（部分版本可能显示为「Run automatically after installation」，作用是让Jenkins自动把工具路径加入PATH）
  2. 核对「提取归档的子目录」的正确性：先手动解压你下载的sonar-scanner-cli包，找到包含sonar-scanner可执行文件的bin目录的相对路径。比如官方包解压后是sonar-scanner-{version}-{os}文件夹，里面的bin目录就是目标，那这里要填sonar-scanner-{version}-{os}/bin（替换成实际的版本和系统标识，比如sonar-scanner-4.8.0.2856-linux/bin）

• 手动强制添加PATH（自动配置失效时用）
  若上面的设置仍不生效，直接在全局环境变量里追加路径：

  1. 进入「Manage Jenkins」→「Configure System」，找到「Global properties」区域
  2. 勾选「Environment variables」，添加一条变量：
     • 名称：PATH
     • 值：$PATH:$JENKINS_HOME/tools/hudson.plugins.sonar.SonarRunnerInstallation/{你的SonarScanner工具名}/bin
       （替换{你的SonarScanner工具名}为你在全局工具配置里给该工具起的名字，比如sonar-scanner-latest）

• Pipeline项目的临时解决办法
  如果是Pipeline脚本构建，直接在脚本里临时注入PATH：

  pipeline {
      agent any
      environment {
          // 把SonarScanner的bin目录加到PATH最前面，避免冲突
          PATH = "${tool 'sonar-scanner-latest'}/bin:${env.PATH}"
      }
      stages {
          stage('SonarQube Analysis') {
              steps {
                  sh 'sonar-scanner -v' // 测试是否能识别命令
              }
          }
      }
  }
  

  这里的sonar-scanner-latest是你在全局工具配置里的SonarScanner工具名称，替换成自己的即可。

• 分布式构建的特殊情况
  如果你用了Jenkins代理节点，要注意SonarScanner的安装位置：

  • 若安装在代理节点，需要在代理节点的工具配置里重复上述步骤，而非主节点
  • 也可以直接在代理节点的系统环境变量里手动添加sonar-scanner的bin路径

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