SonarQube与Backstage集成失败，无法识别已存在项目Key

一、先解决代理域名不一致的问题 #

启动日志里代理目标是https://sonarqube.gcp.cna.com/api，但你配置的是https://sonarqube.gcp.xyz.com/api，这是核心矛盾：

• 检查所有配置文件：别只看app-config.yaml，app-config.local.yaml、app-config.production.yaml这类环境专属配置文件也得排查，有没有覆盖代理设置的情况
• 清理缓存重装依赖：执行yarn cache clean，删除node_modules后重新yarn install，再重启yarn dev，避免旧配置残留
• 核对代理配置格式：确保配置写法正确，示例：

  proxy:
    '/sonarqube':
      target: 'https://sonarqube.gcp.xyz.com/api'
      changeOrigin: true
      pathRewrite: { '^/sonarqube': '' }
  

  注意target的路径是否准确，pathRewrite是否能正确映射请求路径

二、验证请求是否指向配置的baseUrl #

• 打开浏览器开发者工具（F12），切换到Network标签，过滤sonarqube相关请求，查看实际请求的目标地址是否为你配置的https://sonarqube.gcp.xyz.com
• 用curl本地测试代理有效性：

  curl http://localhost:3000/api/sonarqube/projects/search?projects=jupiter-camunda
  

  查看返回结果的来源，同时确认请求头里的API密钥是否正确携带

三、解决项目Key无法识别的问题 #

代理域名修正后，再处理项目Key的问题：

• 确认API密钥权限：该密钥对应的SonarQube用户必须拥有jupiter-camunda项目的浏览权限，去SonarQube后台核对权限设置
• 检查Backstage实体注解：组件yaml文件里的SonarQube注解必须正确，示例：

  metadata:
    annotations:
      sonarqube.org/project-key: 'jupiter-camunda'
  

  注意注解键名要和对应插件版本的文档一致，不同版本可能存在差异
• 直接调用SonarQube API验证：

  curl -u YOUR_API_KEY: https://sonarqube.gcp.xyz.com/api/projects/search?projects=jupiter-camunda
  

  如果返回结果包含该项目，说明问题在Backstage配置；如果没有，检查SonarQube里的项目Key是否拼写正确（注意大小写区分）

四、排查/api/sonarqube/instanceUrl 404问题 #

这个404通常是后端插件未正确注册或路由映射错误：

• 确认sonarqube-backend插件注册状态：检查packages/backend/src/index.ts里是否添加了注册代码：

  import { sonarqubePlugin } from '@backstage/plugin-sonarqube-backend';
  // ...
  const backend = createBackend();
  backend.add(sonarqubePlugin());
  

• 核对插件版本兼容性：@backstage/plugin-sonarqube和@backstage/plugin-sonarqube-backend版本必须一致，避免版本不兼容导致路由失效
• 重启后端服务：修改后端配置或插件注册后，必须重启yarn dev，新配置才会生效

内容的提问来源于stack exchange，提问作者Pradeep Kumar Batchu