SonarQube 7启动失败：找不到Elasticsearch二进制文件

看到你碰到的Cannot find elasticsearch binary错误，这大概率是SonarQube没法定位到内置的Elasticsearch文件导致的，下面是几个实用的排查和修复步骤：

1. 检查SonarQube安装包是否完整解压 #

SonarQube 7自带了Elasticsearch，如果是通过压缩包安装的，很可能是解压过程中出现了文件丢失或损坏：

• 重新下载对应版本的SonarQube安装包（确保从官方渠道获取）
• 删除现有安装目录，用干净的压缩包重新解压，注意不要中断解压过程
• 解压完成后，检查$SONARQUBE_HOME/elasticsearch目录下是否有完整的文件结构，比如bin、config这些子目录，以及bin/elasticsearch（Linux）或bin/elasticsearch.bat（Windows）文件

2. 验证文件权限（Linux/macOS系统） #

如果是在类Unix系统上运行，权限不足会导致SonarQube无法访问Elasticsearch的二进制文件：

• 切换到SonarQube的安装目录，执行命令修改权限：

  chmod -R 755 elasticsearch/
  

• 确保运行SonarQube的用户对elasticsearch目录及其所有子文件有读写执行权限，建议不要用root用户启动SonarQube

3. 检查是否错误配置了自定义Elasticsearch路径 #

如果你尝试过配置外部Elasticsearch，可能是sonar.properties里的配置有误：

• 打开$SONARQUBE_HOME/conf/sonar.properties文件
• 查找是否有sonar.search.javaAdditionalOpts或sonar.search.path这类配置项，如果有，确认路径是否正确；如果不需要外部ES，直接注释掉这些自定义配置，让SonarQube使用内置的ES

4. 确认系统兼容性 #

SonarQube 7对系统环境有一定要求，比如Java版本（需要Java 8或11，注意不要用更高版本），以及Elasticsearch对系统的限制：

• 检查Java版本：执行java -version，确保是兼容的版本
• 对于Linux系统，需要确保禁用了swappiness（可以执行sysctl vm.swappiness=1临时修改，或者写入/etc/sysctl.conf永久生效），同时确保系统满足Elasticsearch的内存要求

如果以上步骤都试过还是不行，可以查看$SONARQUBE_HOME/logs/elasticsearch.log里的详细日志，里面可能会有更具体的错误信息帮你定位问题。

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