Jenkins集成SonarQube时waitForQualityGate返回401错误如何解决

问题原因 #

你遇到的401错误核心是waitForQualityGate步骤调用SonarQube API时没有携带有效授权凭证，触发原因有两类适配/配置问题：

1. SonarQube 8.9+对API权限校验收紧，且Jenkins的SonarQube Scanner插件低版本不支持在waitForQualityGate步骤直接传入credentialsId参数
2. waitForQualityGate默认优先读取Jenkins全局SonarQube服务配置中的凭证，你在步骤中单独传入的凭证参数未生效

解决方案 #

第一步：优先检查全局SonarQube配置（最常见原因） #

进入Jenkins后台「Manage Jenkins」→「Configure System」，找到你命名为SonarQube的服务配置项，确认Server authentication token字段已经配置了scanner-user的有效令牌（可以直接填令牌，也可以选择你存储的全局密文凭证）。waitForQualityGate默认会调用这个全局配置的凭证请求API，优先级高于步骤中传入的参数。
配置完成后重启Jenkins服务重新测试即可。

第二步：确认插件版本适配 #

如果不想用全局凭证，要在waitForQualityGate步骤单独传credentialsId，需要确认你的SonarQube Scanner for Jenkins插件版本≥2.13，只有该版本及以上才支持这个参数。你可以进入Jenkins「插件管理」页面查看插件版本，版本过低的话先升级插件再测试。

第三步：手动校验权限与代理配置 #

如果上述配置都正确，先手动验证令牌权限，执行命令：

curl -u <scanner-user-token>: https://<sonar-url>/api/ce/task?id=AXoxAunUF1YE_9gTnBHP

如果命令返回正常的任务信息，说明令牌本身权限没问题，此时检查SonarQube前端的反向代理配置（如Nginx），确认没有过滤掉Authorization请求头，很多反向代理默认会拦截敏感头导致令牌无法传到SonarQube服务端。

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