GitLab集成SonarQube时无法访问SonarQube server问题求助

网络层排查（优先验证） #

• 直接登录GitLab部署的AWS EC2实例，执行curl -v <你的SonarQube服务完整地址（含端口）>测试连通性，若此步失败可直接判定为网络层面问题，与GitLab本身配置无关。
• 检查SonarQube侧的访问限制：
  • 若SonarQube部署在本地办公环境，确认办公网出口防火墙是否放开了GitLab AWS实例的公网IP访问SonarQube对应端口（默认9000）的权限。
  • 若SonarQube同样部署在AWS，检查SonarQube实例所属的安全组、网络ACL规则，是否放开了GitLab实例的私有IP/关联安全组的入站访问权限。
• 验证域名解析有效性：如果GitLab配置的SonarQube地址是域名形式，在GitLab实例上执行nslookup <SonarQube域名>，确认解析出来的IP地址符合预期，避免本地hosts配置的域名在GitLab服务器无法解析的问题。

GitLab CI/CD运行环境排查 #

• 确认GitLab Runner部署位置：如果是流水线运行时无法连通，且Runner和GitLab主实例没有部署在同一节点，需要登录Runner所在节点重新执行上述连通性测试，GitLab主实例的网络连通性不代表Runner环境的连通性。
• 检查代理配置：如果Runner运行环境需要配置代理才能访问外部服务，确认Runner的环境变量中是否正确配置了HTTP/HTTPS代理，同时需要将SonarQube的地址加入NO_PROXY免代理列表，避免代理规则拦截内部访问请求。
• 验证配置变量正确性：检查GitLab项目/群组/实例级别配置的SONAR_HOST_URL、SONAR_TOKEN变量是否拼写错误，令牌是否有效、未过期，是否被错误标记为受保护变量导致非受保护分支无法读取。

SonarQube服务侧排查 #

• 检查SonarQube的访问控制配置：是否开启了IP白名单限制，未将GitLab、Runner的出口IP加入允许访问列表。
• 查看SonarQube服务日志：确认是否有来自GitLab/Runner IP的访问请求，根据日志中的报错信息针对性处理，比如权限不足、令牌无效等。
• 验证SSL证书有效性：如果SonarQube开启了HTTPS，且使用的是自签名证书，需要将证书导入到GitLab/Runner环境的系统信任证书列表，否则会报SSL证书验证失败的错误。

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