SonarQube服务运行异常求助：Wrapper加载时出现NoSuchMethodError

你遇到的java.lang.NoSuchMethodError本质是logback类版本冲突，虽然你已经清理了部分旧jar，但可能还有隐藏的冲突点或者Wrapper配置没调整到位。下面是一步步的排查和解决思路：

1. 彻底排查所有logback依赖冲突 #

首先要确保整个SonarQube环境里只有你保留的logback-classic-1.2.3.jar（以及配套的logback-core-1.2.3.jar，这个不能缺）：

• 用命令扫描所有相关jar：

  find /opt/sonar -name "logback*.jar"
  

• 重点检查plugins目录，很多自定义或第三方插件会自带logback依赖，要是发现旧版本的logback jar，要么替换插件的依赖版本，要么移除有冲突的插件。
• 确认lib/common目录里的logback-core版本和logback-classic完全匹配，版本不一致也会导致类方法找不到。

2. 调整Wrapper的类加载优先级 #

Wrapper的类加载顺序可能导致它先读到旧版本的logback类，需要在wrapper.conf里强制指定优先加载正确的jar：

• 打开/opt/sonar/conf/wrapper.conf，找到以wrapper.java.classpath开头的配置项。
• 把logback的两个jar放在类路径最前面，比如：

  wrapper.java.classpath.1=/opt/sonar/lib/common/logback-core-1.2.3.jar
  wrapper.java.classpath.2=/opt/sonar/lib/common/logback-classic-1.2.3.jar
  

  注意后面的序号要顺延，不要覆盖原来的其他配置项。

3. 确保Wrapper日志配置正确且有权限 #

Wrapper无法正常记录日志可能是路径不对或者权限不足：

• 在wrapper.conf里检查这几个关键配置：

  # 指定Wrapper日志文件路径
  wrapper.logfile=/opt/sonar/logs/wrapper.log
  # 设置日志级别，调试时可以改成DEBUG
  wrapper.logfile.loglevel=INFO
  # 控制台日志输出级别
  wrapper.console.loglevel=INFO
  

• 检查/opt/sonar/logs目录的权限，确保SonarQube运行用户（通常是sonar用户）有读写权限：

  ls -ld /opt/sonar/logs
  chown -R sonar:sonar /opt/sonar/logs  # 如果权限不对就执行这个
  

4. 彻底重启服务并验证 #

做完上面的调整后，一定要彻底重启服务，避免残留的旧类加载在内存里：

• 停止服务：

  # 如果用systemd管理
  systemctl stop sonarqube
  # 或者用SonarQube自带脚本
  /opt/sonar/bin/linux-x86-64/sonar.sh stop
  

• 可以清空旧日志方便查看新输出：

  rm -f /opt/sonar/logs/*.log
  

• 启动服务后立刻查看wrapper.log和sonar.log，如果还有错误，重点看是否还有其他类冲突的提示。

5. 确认SonarQube版本兼容性 #

最后提醒一下：不要随意替换SonarQube官方自带的依赖jar，不同版本的SonarQube对logback的依赖版本是固定的。如果是你手动替换了logback版本，建议先换回官方默认的版本，再排查冲突——有时候问题就是因为版本不兼容导致的。

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