VSTS YAML构建中SonarQube服务端点引用失败问题求助

我之前也碰到过一模一样的情况——非YAML构建里好好的SonarQube服务端点，转成YAML后就报“服务端点不存在或未授权”的错误，折腾了好一阵才解决，给你分享几个经过验证的排查和解决步骤：

• 检查构建服务账号的权限：
  非YAML构建可能默认用了有足够权限的账号，但YAML构建通常依赖Project Collection Build Service ({你的组织名})这个系统账号。你得去项目设置的服务连接里找到对应的SonarQube端点，点击右上角的“...”选择“权限”，确保这个构建服务账号拥有“使用”权限。如果没有，添加权限并保存即可。

• 严格核对服务端点名称的细节：
  VSTS的服务连接名称是大小写敏感的，哪怕差一个字母的大小写、多了个空格都会匹配失败。建议直接从服务连接页面复制名称，粘贴到YAML的对应参数里，别手动输入避免拼写错误。

• 确认YAML任务参数与版本匹配：
  不同版本的SonarQube任务参数名可能有变化，比如旧版SonarQubePrepare@3用的是connectedServiceName，而新版SonarQubePrepare@4已经改用SonarQube作为服务端点的参数名。你可以在YAML编辑器里点击任务旁的“i”图标，查看当前任务版本的官方参数说明，确保参数名正确。

• 尝试重新创建服务端点：
  有时候服务端点的加密凭据会在格式转换时失效，或者存在隐藏的配置问题。你可以先删除现有SonarQube服务端点，重新创建一个完全相同的配置，再更新YAML里的服务名称，触发构建测试。

• 核对代理池配置一致性：
  如果你的非YAML构建用了特定的私有代理池，而YAML构建默认用了公共代理池，也可能导致权限问题。确保YAML里指定的代理池和非YAML构建一致，或者给当前代理池的服务账号添加服务端点的使用权限。

给你贴个正确的YAML任务示例（以SonarQubePrepare@4为例）：

- task: SonarQubePrepare@4
  inputs:
    SonarQube: 'MySonarQubeEndpoint' # 替换成你的服务端点名称
    scannerMode: 'MSBuild'
    projectKey: 'MyProjectKey'
    projectName: 'MyProjectName'

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