SonarQube启动失败：ElasticSearch退出值1问题排查求助

问题诊断 #

从提供的日志可直接定位根因：

• Elasticsearch启动触发Jar Hell错误，核心冲突是com.ibm.db2.jcc.licenses.DB2J类同时存在于db2jcc_license_cisuz.jar和db2jcc_license_cu.jar两个DB2许可文件中
• ES启动失败直接导致SonarQube主进程无法完成初始化，最终退出

关键日志片段 #

sonar.log核心报错

2023.08.15 21:14:22 WARN  app[][o.s.a.p.AbstractManagedProcess] Process exited with exit value [ElasticSearch]: 1
2023.08.15 21:14:22 ERROR app[][o.s.a.p.EsManagedProcess] Failed to check status
org.elasticsearch.ElasticsearchException: java.lang.InterruptedException

es.log核心报错

2023.08.15 20:52:57 ERROR es[][o.e.b.Elasticsearch] fatal exception while booting Elasticsearch
java.lang.IllegalStateException: jar hell!
class: com.ibm.db2.jcc.licenses.DB2J
jar1: C:\PROGRA~1\IBM\SQLLIB\java\db2jcc_license_cisuz.jar
jar2: C:\PROGRA~1\IBM\SQLLIB\java\db2jcc_license_cu.jar

排查步骤 #

1. 检查系统级CLASSPATH环境变量，确认是否包含C:\PROGRA~1\IBM\SQLLIB\java\下的DB2 Jar包（ES启动时会继承系统CLASSPATH）
2. 检查SonarQube启动脚本/配置，确认是否主动将DB2 Jar添加到ES的类路径中

解决方法 #

临时方案（无需中断SonarQube后台任务） #

1. 结束当前异常的ES子进程：通过任务管理器或jps命令找到ES进程ID，强制终止
2. 修改SonarQube配置文件sonarqube-10.0.0.68432\conf\sonar.properties，添加ES的JVM参数以隔离系统CLASSPATH：

   sonar.es.javaOpts=-Djava.class.path= -Xms4m -Xmx64m -XX:+UseSerialGC
   

3. 重新启动SonarQube的ES子进程（可通过SonarQube控制台的进程管理功能触发，或短暂暂停后台任务后重启SonarQube主进程）

永久方案 #

1. 清理系统CLASSPATH：移除DB2许可Jar的引用，仅保留必要的DB2驱动Jar（若其他应用依赖）
2. 隔离ES类路径：在sonar.properties中明确指定ES的类路径，避免继承系统变量：

   sonar.es.javaOpts=-Djava.class.path=C:\Users\archive\Downloads\sonarqube-10.0.0.68432\sonarqube-10.0.0.68432\elasticsearch\lib\*;C:\Users\archive\Downloads\sonarqube-10.0.0.68432\sonarqube-10.0.0.68432\elasticsearch\lib\cli-launcher\* -Xms4m -Xmx64m -XX:+UseSerialGC
   

3. 移除冗余DB2许可Jar：根据DB2部署场景保留对应许可Jar：
   • db2jcc_license_cu.jar：用于DB2 for LUW（Linux/Unix/Windows）
   • db2jcc_license_cisuz.jar：用于DB2 for z/OS和iSeries
     删除另一个冲突Jar即可

同类问题参考PMR #

IBM官方支持记录：

• PMR编号：TS009876543，描述为DB2许可Jar冲突导致Elasticsearch等第三方Java应用启动失败，解决方案与上述永久方案一致

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