Bitbucket Pipeline集成SonarQube时SONAR_HOST_URL无法访问如何解决

为什么本地localhost:9000无法访问 #

Bitbucket Pipeline默认使用Atlassian托管的云端运行环境，和你本地部署的SonarQube服务不在同一网络内，天然无法访问localhost:9000地址，这是初始配置报错的核心原因。

公网地址依然报错的排查步骤 #

• 第一步：检查配置规范
  SONAR_HOST_URL必须填写完整的服务根地址，需要携带http://或https://前缀，不要遗漏协议头，也不要额外添加/projects之类的子路径。另外你当前的质量门禁pipe没有配置SONAR_HOST_URL，虽然官方说明会从扫描结果中读取地址，仍建议显式配置避免读取异常。
  修正后的配置参考：

  - pipe: sonarsource/sonarqube-scan:1.0.0
    variables:
      SONAR_HOST_URL: ${SONAR_HOST_URL}
      SONAR_TOKEN: ${SONAR_TOKEN}
  - pipe: sonarsource/sonarqube-quality-gate:1.0.0
    variables:
      SONAR_HOST_URL: ${SONAR_HOST_URL}
      SONAR_TOKEN: ${SONAR_TOKEN}
  

• 第二步：确认Bitbucket变量配置正确
  你需要在Bitbucket仓库的「Settings -> Pipelines -> Repository variables」中正确配置SONAR_HOST_URL，变量值不要加引号，确认没有拼写错误。可以在流水线中添加调试命令打印变量验证：

  - echo "Current SONAR_HOST_URL: ${SONAR_HOST_URL}"
  

  运行流水线后查看该步骤输出，确认地址和你预期的公网地址一致。
• 第三步：检查公网SonarQube的访问限制
  1. 确认该公网地址在本地浏览器可以正常访问，服务运行正常，没有端口拦截、反向代理配置错误的问题。
  2. 如果你的SonarQube配置了IP白名单，需要将Bitbucket Cloud的公开出口IP段添加到放行列表，允许流水线节点访问你的SonarQube服务端口。
  3. 如果使用HTTPS协议，确认证书是公网信任的正规证书，自签名证书会导致流水线请求时SSL校验失败，表现为无法访问服务。

SONAR_HOST_URL正确配置规则 #

填写可以从Bitbucket Pipeline运行环境正常访问的SonarQube服务根地址即可，比如你公网部署的服务地址为https://sonar.yourdomain.com，直接将该值配置为SONAR_HOST_URL变量即可。

内容的提问来源于stack exchange，提问作者Md. Parvez Alam