安装json-plugin后SonarQube 9.9社区版无法启动求助

问题现象 #

• 环境：Windows系统上的SonarQube 9.9社区版，升级自8.8版本，原本运行正常
• 操作：将GitHub上下载的第三方json-plugin jar包放入${SONARQUBE_HOME}/extensions/plugins目录后重启服务
• 异常表现：SonarQube启动失败，日志显示Web Server进程先停止，随后Elasticsearch也终止运行；删除该插件后服务可正常启动，且该插件在8.8版本中能正常工作

核心原因 #

SonarQube 9.9 LTS作为长期支持版本，对第三方插件的兼容性要求远高于8.8版本：

• API版本不兼容：9.x系列的SonarQube API与8.8存在较大差异，旧版插件未适配9.9的API规范，加载时触发Web Server初始化错误，进而导致整个服务链崩溃
• 权限与依赖校验增强：9.x版本强化了插件的依赖验证和权限管控，第三方插件可能缺少必要的权限声明或依赖包，无法通过启动校验

可行解决方案 #

• 找兼容版本插件：确认该第三方json-plugin是否有适配SonarQube 9.x的发布版本，优先使用官方或维护者更新后的兼容包
• 自行适配插件：如果有开发能力，下载插件源码，修改pom.xml中SonarQube API的依赖版本为9.9对应版本，重新编译打包后测试部署
• 替代方案：使用SonarQube 9.9内置的基础JSON扫描规则（部分核心规则已默认支持），或通过自定义规则实现特定的JSON扫描需求，避免使用未兼容的第三方插件

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