Azure Pipeline集成SonarQube时无满足需求的代理报错如何解决

错误核心原因：SonarQube任务要求运行代理必须满足两个条件：安装Java运行环境、代理版本高于2.144.0，你当前选择的代理池内没有符合要求的代理节点。

按照以下顺序排查即可解决：

• 核对代理池选择配置 #

  报错信息中代理池名称为空，首先检查流水线的代理池配置项，确认你选择了正确的代理池，避免误选空池或无权限访问的池。

• 校验自托管代理版本（使用自托管代理场景） #

  1. 进入Azure DevOps项目后台的代理池管理页，找到对应池下的目标代理节点，查看版本号是否大于2.144.0
  2. 若版本不达标，下载最新版Azure DevOps代理安装包，在代理服务器上完成升级后重启代理服务即可

• 配置代理Java运行环境 #

  1. 登录代理所在服务器，执行java -version确认是否安装了Java 11/17（SonarQube当前支持的LTS版本）
  2. 未安装Java则先完成安装，将Java执行路径加入系统环境变量PATH
  3. 重启Azure DevOps代理服务，系统会自动识别Java能力并更新代理的capabilities标识；也可以手动在代理属性中添加java能力项，让平台识别该代理满足要求

• 替代方案：使用微软托管代理 #

  无需调整自托管代理配置的前提下，直接将流水线的代理镜像设置为ubuntu-latest或windows-latest，微软托管的公共镜像默认预装了符合要求的Java环境与最新版代理，可直接运行SonarQube任务。

相关参考截图 #

内容的提问来源于stack exchange，提问作者Anthony Earl R. Cuartero