Azure DevOps Pipeline特定阶段在特定自托管Agent机器队列中卡住求助

1. 验证SonarQube依赖与权限 #

• 检查Agent机器是否安装了对应版本的SonarQube Scanner，执行命令sonar-scanner --version确认版本匹配Pipeline要求
• 测试Agent到SonarQube服务器的连通性：执行curl -u <你的SonarToken>: <SonarQube地址>/api/system/status，确保能返回正常状态
• 查看Agent机器上的sonar-scanner.properties配置，确认服务器地址、token等参数正确

2. 排查Agent自身状态与日志 #

• 打开Agent安装目录下_diag文件夹的日志文件，搜索SonarQube相关关键词，定位是否有连接超时、权限报错等信息
• 任务卡队列时，检查Agent机器的CPU、内存、磁盘使用率，排除资源过载导致无法承接任务的情况
• 登录Azure DevOps查看该Agent的Capabilities，确认是否包含SonarQube相关的能力标记（比如sonarscanner），且与Pipeline阶段的需求匹配

3. 对比Pipeline配置与手动测试 #

• 对比能正常运行该阶段的Agent，检查Pipeline中SonarQube阶段的变量、参数是否有针对故障Agent的特殊设置
• 在故障Agent上手动执行Pipeline中的SonarQube分析命令，模拟完整执行流程，确认是否能正常完成，排除Pipeline配置问题

4. 系统层面深层排查 #

• 检查Agent机器的防火墙规则，确保允许Azure DevOps服务、SonarQube服务器的双向通信（默认开放SonarQube的9000端口）
• 尝试将Azure DevOps Agent服务切换为本地管理员账户运行，排除账户权限不足的问题
• 临时关闭机器上的杀毒软件、安全防护工具，测试是否被拦截导致任务无法启动

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