Backstage集成SonarQube插件失败：配置后仍无法获取数据

问题核心 #

控制台报错：Couldn't find a default sonarqube instance in the config. Either configure an instance with name default or add a prefix to your annotation value.
界面提示：“无信息可显示，不存在密钥为'Project-web'的SonarQube项目”

修复步骤 #

1. 检查后端SonarQube实例配置 #

打开Backstage后端配置文件（通常为app-config.yaml），确认SonarQube配置段包含名为default的实例：

sonarqube:
  instances:
    - name: default
      baseUrl: https://你的SonarQube服务地址
      token: ${SONARQUBE_TOKEN} # 可填环境变量或直接写入有效令牌

若你配置的SonarQube实例名不是default（比如sonar-prod），需在实体注解中指定对应前缀。

2. 修正实体注解格式 #

在你的Backstage实体配置文件（如catalog-info.yaml）中，根据实例配置调整注解：

• 若使用default实例，注解格式为：

  annotations:
    sonarqube.org/project-key: Project-web
  

• 若实例名非default（如sonar-prod），注解需添加实例前缀：

  annotations:
    sonarqube.org/sonar-prod/project-key: Project-web
  

同时确认Project-web是SonarQube中真实存在的项目密钥（可在SonarQube项目设置的“密钥”选项中核对）。

3. 重启Backstage后端服务 #

修改配置或注解后，必须重启Backstage后端，确保新配置生效。

4. 验证同步效果 #

重新加载Backstage对应的实体页面，或触发Catalog重新索引，确认SonarQube数据是否正常显示。

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