Jenkins配置SonarQube分析Maven项目时遇scmsvn插件实例化失败

你遇到的这个java.lang.IllegalStateException: Fail to instantiate class [org.sonar.plugins.scm.svn.SvnPlugin]错误，通常和SCM SVN插件与SonarQube版本不兼容、依赖缺失，或者Jenkins环境的SVN配置问题有关。下面是几个经过验证的解决步骤：

1. 核对SonarQube与SCM SVN插件的版本兼容性 #

这是最常见的触发原因——不同版本的SonarQube对插件的依赖版本要求严格：

• 登录你的SonarQube服务器，进入「Administration > Marketplace」，找到SCM SVN插件，查看它标注的兼容SonarQube版本范围。
• 如果你的SonarQube版本不在这个范围内，要么升级SonarQube到兼容版本，要么降级SCM SVN插件到匹配的旧版本，操作完成后务必重启SonarQube服务器。

2. 重新安装SCM SVN插件 #

有时候插件安装过程中可能出现文件损坏或加载不完整的情况：

• 在SonarQube插件市场中卸载当前的SCM SVN插件，然后重新下载对应兼容版本的插件进行安装。
• 安装完成后重启SonarQube，确保插件能正常加载。

3. 检查Jenkins环境的SVN客户端配置 #

SonarScanner需要调用SVN客户端完成SCM分析，所以Jenkins环境的SVN配置必须正常：

• 确认Jenkins服务器上安装了符合要求的SVN客户端（比如SCM SVN插件3.x版本需要Subversion 1.8及以上）。
• 进入Jenkins的「Global Tool Configuration」，配置好SVN的安装路径，确保SonarScanner能正常调用svn命令。可以在Jenkins的构建步骤里先执行svn --version验证SVN是否可用。

4. 禁用SCM分析（临时应急方案） #

如果你的项目不需要SCM相关的代码分析，可以直接跳过这部分逻辑：

• 在Jenkins的SonarQube分析参数中添加-Dsonar.scm.disabled=true，这样SonarScanner会跳过SCM插件的加载，避免实例化错误。

5. 查看详细日志定位依赖问题 #

如果以上方法都没用，就需要通过日志深挖问题：

• 查看SonarQube服务器的日志文件（通常在$SONARQUBE_HOME/logs目录下的web.log或ce.log），里面会有更具体的异常堆栈，比如是否缺少某个SVN相关的依赖jar包。
• 如果是依赖缺失，可以手动下载对应的jar包，放到SonarQube的插件目录（$SONARQUBE_HOME/extensions/plugins），然后重启服务。

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