在自托管VSTS代理上运行sonar-scanner时出现组件加载失败错误

从你给出的错误日志来看，核心问题是SonarQube Scanner在加载org.sonar.scanner.report.Act...相关组件时失败，结合你的环境（Linux Kubernetes集群上的自托管VSTS代理），我整理了几个实战中有效的排查和解决方向：

1. 先确认版本兼容性 #

SonarQube Scanner和SonarQube服务器的版本必须严格匹配，这是最常见的坑。比如如果你的SonarQube服务器是9.x版本，那Scanner也得用对应9.x系列的版本，不能用8.x的旧版本。

• 在VSTS的SonarQube任务配置里，检查是否指定了正确的Scanner版本；如果是代理本地安装的Scanner，直接查看其版本（执行sonar-scanner -v），和SonarQube服务器版本对比，不匹配的话赶紧升级/降级到兼容版本。

2. 检查代理容器的Java环境 #

SonarQube Scanner依赖Java运行时，不同版本的Scanner对Java版本要求不同（比如9.x Scanner需要Java 11或17）：

• 进入代理容器执行以下命令确认Java版本：

  java -version
  

• 如果版本不符合要求，修改代理的Dockerfile，安装对应版本的OpenJDK或Oracle JDK，重新构建镜像部署。

3. 排查文件权限问题 #

Kubernetes容器里的运行用户通常权限有限，很可能没有访问Scanner安装目录或临时文件的权限：

• 检查Scanner安装目录的权限：

  ls -ld /opt/sonar-scanner  # 替换成你的实际安装路径
  

• 确保运行代理的用户对该目录有读+执行权限，对临时目录（比如/tmp）有读+写权限。可以在Dockerfile里添加chown或chmod命令调整权限。

4. 清理Scanner缓存 #

缓存损坏也会导致组件加载失败：

• 找到Scanner的缓存目录（通常在代理用户的~/.sonar/cache），删除整个缓存文件夹：

  rm -rf ~/.sonar/cache
  

• 然后重新触发VSTS的分析任务，让Scanner重新下载必要的组件。

5. 验证网络连通性 #

代理容器必须能正常访问SonarQube服务器，否则无法下载组件或上报数据：

• 在容器里执行curl命令测试连通性：

  curl -I http://your-sonarqube-server:9000  # 替换成你的SonarQube地址
  

• 如果不通，检查Kubernetes的网络策略、Service配置，或者代理是否在有网络限制的命名空间里，确保流量能正常到达SonarQube服务器。

6. 重新部署代理容器 #

如果以上都没用，可能是代理容器的文件系统出现了损坏：

• 重新构建代理镜像，确保所有依赖（包括SonarQube Scanner）都正确安装；
• 删除旧的代理Pod，让Kubernetes重新部署新的实例。

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