本地Visual Studio无法连接带自签名证书的SonarQube服务器求助

我之前也碰到过几乎一模一样的问题——浏览器能正常访问SonarQube，本地部署的服务器也能连，但Visual Studio就是连不上远程服务器。结合你的情况，大概率是下面这几个常见问题导致的，你可以逐一排查：

• 服务器端的网络/权限限制
  很多时候浏览器能访问是因为服务器开放了前端页面的访问，但Visual Studio连接时调用的是SonarQube的API接口（路径以/api开头），这部分可能被单独限制了：

  • 检查服务器的防火墙/安全组，确认Visual Studio所在机器的IP不在拦截列表里，且SonarQube的端口（默认9000）是开放的；
  • 查看SonarQube的配置文件sonar.properties，确认sonar.web.host没有绑定到仅本地可访问的IP（比如127.0.0.1），而是设置成了允许外部访问的地址；
  • 如果服务器用了反向代理（比如Nginx），要确认代理规则里没有拦截/api开头的请求，并且正确转发到SonarQube服务。

• Visual Studio SonarQube扩展的配置问题
  细节错误很容易被忽略：

  • 先确认VS里填写的服务器地址和浏览器完全一致，比如浏览器用的是http://sonar.company.com，VS里别多打斜杠、写错端口或者加了不必要的后缀；
  • 尝试清除扩展缓存：打开「工具」->「选项」->「SonarQube」，删除现有服务器配置，重新添加并输入账号密码；
  • 检查扩展版本，旧版本可能和远程服务器的SonarQube版本不兼容，去Visual Studio Marketplace更新到最新版的SonarQube扩展。

• 代理设置不匹配
  浏览器和VS的代理设置可能不一样：

  • 打开VS的「工具」->「选项」->「环境」->「Web浏览器」->「代理设置」，确认和浏览器的代理配置一致；
  • 如果服务器用HTTPS，VS的扩展可能没信任服务器的SSL证书，导致连接失败。可以把服务器的证书导入到系统的信任根证书库，或者在扩展设置里临时关闭证书校验（不推荐生产环境）。

• 账号权限或凭据问题
  虽然你能用账号密码登录管理员账户，但还有两点要注意：

  • 确认该账号拥有执行分析的权限（管理员账号默认有，但有些企业会调整权限）；
  • 试试用用户令牌代替账号密码：登录SonarQube网页，进入「我的账号」->「安全」生成令牌，在VS里配置时用令牌作为密码输入——有时候密码里的特殊字符会导致VS解析出错，令牌更稳定。

• DNS解析问题
  浏览器可能通过企业DNS或本地hosts文件正确解析服务器地址，但VS用的DNS不一样：

  • 在命令行里执行ping [服务器地址]和nslookup [服务器地址]，检查解析的IP是否和浏览器访问的一致；
  • 如果解析错误，手动在本地hosts文件里添加服务器IP和域名的映射。

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