Docker部署Jenkins+SonarQube插件扫描时工具未找到求助

根据你遇到的/var/jenkins_home/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonarqube/bin/sonarqube: not found报错，以下是针对性的排查和解决步骤：

1. 验证工具目录的实际文件结构 #

首先进入Jenkins容器确认配置路径下的文件是否存在：

docker exec -it <你的Jenkins容器ID/名称> bash
# 查看工具目录内容
ls -la /var/jenkins_home/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonarqube/

• 如果目录为空或bin文件夹下没有可执行文件，说明自动安装失败，需要手动部署SonarScanner（注意：当前SonarQube扫描工具官方名称为SonarScanner，旧版SonarRunner已被废弃）。
• 手动下载并部署兼容版本的SonarScanner：

cd /var/jenkins_home/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonarqube/
# 替换为对应SonarQube版本兼容的SonarScanner下载链接（示例为5.0.1版）
wget https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-5.0.1.3006-linux.zip
unzip sonar-scanner-cli-5.0.1.3006-linux.zip
mv sonar-scanner-5.0.1.3006-linux/* .
rm -rf sonar-scanner-cli-5.0.1.3006-linux.zip sonar-scanner-5.0.1.3006-linux

• 检查bin目录，正确的可执行文件是sonar-scanner而非sonarqube，这是常见的配置混淆点。

2. 修正Jenkins的SonarQube工具配置 #

进入Jenkins管理界面 → 全局工具配置：

• 找到SonarQube Scanner配置项（注意：新版插件已替换旧的SonarRunner），确认工具名称为sonarqube。
• 如果之前选择自动安装失败，切换为解压后使用，并指定正确的可执行文件路径：/var/jenkins_home/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonarqube/bin/sonar-scanner。
• 保存配置后重新触发构建。

3. 调整Jenkinsfile中的扫描命令 #

避免直接调用错误的绝对路径，使用插件提供的环境变量或标准命令：

stage('SonarQube Scan') {
    steps {
        withSonarQubeEnv('sonarqube') {
            sh 'sonar-scanner'
        }
    }
}

withSonarQubeEnv会自动注入SonarScanner的环境变量，无需手动指定路径。

4. 修复文件权限问题 #

确保Jenkins容器内的jenkins用户对工具目录有完整权限：

chown -R jenkins:jenkins /var/jenkins_home/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonarqube/
chmod +x /var/jenkins_home/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonarqube/bin/sonar-scanner

5. 确认插件与工具版本兼容性 #

• 检查Jenkins的SonarQube插件版本，确保与SonarQube服务器版本兼容。
• SonarScanner版本需匹配SonarQube服务器版本（例如SonarQube 9.x对应SonarScanner 4.x/5.x），避免因版本不匹配导致的路径或执行问题。

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