Jenkins Pipeline执行SonarQube Scanner认证失败求助

可能的原因及排查方向 #

1. Token参数名不匹配 #

SonarQube 9.9及以上版本官方推荐使用sonar.token作为token的传递参数，虽兼容旧的sonar.login，但部分环境可能存在解析异常。尝试将命令中的-Dsonar.login=替换为-Dsonar.token=后重新执行扫描。

2. Token权限未覆盖场景 #

• 若为首次扫描该项目Key，确认token所属用户拥有项目创建权限；若项目已存在，需确保用户拥有项目分析权限。
• 检查SonarQube全局权限设置：开启"强制用户认证"后，需确认该用户所属组未被限制分析权限。

3. Jenkins凭证传递逻辑问题 #

• 避免在命令行明文写token，建议通过Jenkins凭证管理+withSonarQubeEnv步骤传递认证信息，示例Pipeline代码：

  withSonarQubeEnv('你的SonarQube服务器配置名称') {
      sh '/root/jenkins-slave/tools/hudson.plugins.sonar.SonarRunnerInstallation/sonar/bin/sonar-scanner -Dsonar.projectKey=AHN-frontend-next.js-cms -Dsonar.sources=.'
  }
  

• 在Jenkins slave节点执行测试命令，验证网络连通性与token有效性：

  curl -u squ_daf0821b5f40d18f1442e78918daba8eb645f7d9: https://sonarqube.techdigitem.com/api/system/status
  

  若返回正常JSON响应，说明网络和token本身有效；若返回401，则需排查SonarQube端的token状态。

4. SonarQube服务器端异常 #

• 登录SonarQube后台，确认该token未被禁用或删除。
• 检查Jenkins SonarQube插件版本与SonarQube服务器版本是否兼容，插件版本过低可能不支持新的认证逻辑。

5. 命令行参数语法错误 #

• 检查项目Key等参数是否包含特殊字符，是否存在转义错误；确认参数间无多余空格。
• 确保SonarQube URL末尾无多余斜杠，部分环境下会导致认证请求路径异常。

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