SonarQube升级后出现指定质量配置文件不存在问题求助

问题根源分析 #

从5.5升级到6.7.2 LTS的过程中，内置的Sonar way质量配置文件的标识（ID）发生了变更，而系统里可能还残留着指向旧ID（就是错误里的java-sonar-way-64367）的关联配置——比如项目绑定记录、数据库里的旧引用，导致你清理时触发了“配置不存在”的报错。

分步解决方法 #

1. 确认当前有效配置的真实ID
   登录SonarQube后台，进入Quality Profiles页面，找到Java语言下的Sonar way配置文件。点击进入后，从浏览器地址栏可以看到它的实际ID（比如地址是/quality_profiles/show?key=java-sonar-way，那有效ID就是java-sonar-way），对比错误里的旧ID，确认两者确实不一致。

2. 修正项目与配置的绑定关系

   • 手动检查：进入Projects页面，逐个查看项目的质量配置绑定情况，把仍绑定旧ID的项目切换到新的Sonar way默认配置。
   • 批量处理（可选）：用SonarQube API快速排查并更新：
     先查询所有项目的配置绑定：

     curl -u 你的管理员令牌: "http://你的SonarQube地址/api/projects/search?ps=500" | jq '.components[] | {项目Key: .key, 绑定的配置: .qualityProfiles[]}'
     

     找到绑定旧配置的项目后，执行以下命令统一设置默认配置：

     curl -u 你的管理员令牌: -X POST "http://你的SonarQube地址/api/qualityprofiles/set_default?language=java&qualityProfile=java-sonar-way"
     

3. 清理数据库中的残留旧记录

   重要提醒：操作数据库前务必做好完整备份！

   • 连接SonarQube的数据库，先查询旧配置的残留数据：

     -- 查询旧配置文件本身
     SELECT * FROM quality_profiles WHERE kee = 'java-sonar-way-64367';
     -- 查询关联的项目绑定记录
     SELECT * FROM project_qprofiles WHERE qprofile_uuid = (SELECT uuid FROM quality_profiles WHERE kee = 'java-sonar-way-64367');
     

   • 如果存在上述记录，先删除关联的项目绑定，再删除旧配置文件：

     DELETE FROM project_qprofiles WHERE qprofile_uuid = (SELECT uuid FROM quality_profiles WHERE kee = 'java-sonar-way-64367');
     DELETE FROM quality_profiles WHERE kee = 'java-sonar-way-64367';
     

4. 重启SonarQube并重新尝试清理
   完成上述操作后，重启SonarQube服务让配置生效。回到Quality Profiles页面，确认Sonar way已设为默认，再删除旧的废弃配置文件，此时应该就不会再出现ID不存在的错误了。

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