SonarQube Dependency-check插件UI报错‘Page extension failed’，求排查步骤

1. 确认插件版本兼容性 #

SonarQube 10.0社区版属于较新版本，Dependency-Check插件可能存在适配问题。查看插件市场中该插件的支持版本范围，确认当前安装的插件版本是否明确兼容SonarQube 10.0。如果版本不匹配，可降级插件到官方标注兼容10.0的版本，或升级到最新兼容版本。

2. 查看浏览器控制台错误 #

打开「More→Dependency-Check」页面时按F12调出开发者工具，切换到Console标签页，检查是否存在JS报错、资源加载失败（如404、500状态码）的信息。这类前端错误通常是页面渲染失败的直接原因，比如插件前端组件缺失或加载异常。

3. 重新上传报告并校验路径权限 #

• 确认sonar.dependencyCheck.htmlReportPath配置的是绝对路径，或者相对于sonar-scanner执行目录的相对路径，保证Sonar服务器能正常读取报告文件。
• 手动清理Sonar项目中已上传的Dependency-Check报告（可通过项目设置的分析报告选项清理，或直接删除Sonar服务器存储目录中对应项目的报告文件），然后重新执行sonar-scanner上传报告，观察页面是否恢复正常。

4. 清理插件缓存并重启Sonar服务 #

• 登录SonarQube服务器，清理$SONARQUBE_HOME/data/plugins目录下的插件缓存，然后重启SonarQube服务。插件缓存损坏可能导致页面扩展组件无法正常加载。
• 重启后再次执行sonar-scanner扫描，确保报告重新被解析和上传。

5. 校验报告格式规范 #

虽然已确认报告内容有效，仍需进一步检查：

• 直接用浏览器打开本地的dependency-check-report.html，确认页面能正常渲染，无语法错误或资源引用问题。
• 使用JSON校验工具检查dependency-check-report.json的结构，确认不存在字段缺失、语法错误，符合插件的预期格式。

6. 检查用户权限 #

确保当前登录账号拥有项目管理员权限，部分插件页面需要较高权限才能正常加载。尝试使用SonarQube管理员账号登录，访问该页面看是否仍报错。

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