Sonarqube因Elasticsearch异常无法启动，如何修复以启动Web服务？

系统信息 #

• 内存：4GB
• 存储：20GB SSD
• 操作系统：Ubuntu 20
• 实例环境：GCP
• JDK版本：openjdk 11.0.16 2022-07-19
  • OpenJDK Runtime Environment (build 11.0.16+8-post-Debian-1deb11u1)
  • OpenJDK 64-Bit Server VM (build 11.0.16+8-post-Debian-1deb11u1, mixed mode, sharing)
• 数据库：PostgreSQL

已配置的系统参数 #

已修改以下系统配置：

# /etc/sysctl.conf
vm.max_map_count=524288
fs.file-max=131072

# /etc/security/limits.conf
LimitNOFILE=131072
LimitNPROC=8192

Elasticsearch日志分析 #

从提供的es.log内容来看，Elasticsearch实例成功启动并完成集群初始化，但在启动7秒后被正常停止，日志中没有报错信息。这说明Elasticsearch本身没有问题，SonarQube Web服务器启动失败的原因应该在SonarQube主服务或数据库连接环节。

修复步骤 #

1. 查看SonarQube主日志 #

检查SonarQube安装目录下的logs/sonar.log，这里会记录Web服务启动过程中的错误，比如数据库连接失败、权限不足、配置错误等关键信息。

2. 验证PostgreSQL连接配置 #

编辑SonarQube的conf/sonar.properties文件，确认以下数据库配置项正确：

sonar.jdbc.url=jdbc:postgresql://localhost/sonarqube
sonar.jdbc.username=sonarqube_user
sonar.jdbc.password=your_password

同时确保：

• PostgreSQL服务处于运行状态：sudo systemctl status postgresql
• SonarQube数据库用户拥有对应数据库的读写权限
• 防火墙或PostgreSQL配置允许本地连接（如果是远程数据库则需验证网络连通性）

3. 确认系统参数生效 #

之前配置的内核和资源限制需要确保生效：

• 验证内核参数：

  sysctl vm.max_map_count
  sysctl fs.file-max
  

  输出应分别为524288和131072，若未生效执行sudo sysctl -p重新加载配置。
• 切换到SonarQube运行用户（不能是root），验证资源限制：

  ulimit -n  # 应返回131072
  ulimit -u  # 应返回8192
  

  若未生效，需重启系统，或确保SonarQube服务通过systemd配置加载了这些限制（在service文件中添加LimitNOFILE=131072等参数）。

4. 修复目录权限问题 #

确保SonarQube安装目录的所有者为运行SonarQube的用户（例如sonarqube）：

sudo chown -R sonarqube:sonarqube /opt/sonarqube/sonarqube-9.6.0.59041

5. 调整JVM内存配置 #

根据服务器4GB内存的情况，合理分配JVM内存：

• 在conf/sonar.properties中配置Web服务的JVM参数：

  sonar.web.javaOpts=-Xmx1G -Xms1G -XX:+HeapDumpOnOutOfMemoryError
  

• Elasticsearch的当前内存配置（512M）是合理的，无需调整。

6. 检查端口占用情况 #

确认SonarQube默认的Web端口（9000）未被其他服务占用：

ss -tulpn | grep 9000

若端口被占用，可修改sonar.properties中的sonar.web.port参数更换端口。

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