SonarQube项目显示零问题且ES搜索请求失败求助

我之前处理过好几起类似的SonarQube Elasticsearch相关故障，结合你的环境（SonarQube 5.6.7、Ubuntu 16.04 LTS、MySQL 5.7、18GB数据库）和症状，给你几个针对性的排查修复步骤：

1. 优先检查Elasticsearch的资源配置 #

SonarQube 5.6.7自带的Elasticsearch版本是2.3.3，这个版本对内存资源比较敏感，18GB的数据库需要足够的堆内存来支撑索引和搜索操作。默认的堆内存配置（通常是256M或512M）肯定不够用，这很可能是导致索引损坏、搜索失败的核心原因。

• 编辑SONARQUBE_HOME/conf/sonar.properties文件，找到sonar.search.javaOpts参数，修改为合适的堆内存值：

  sonar.search.javaOpts=-Xms2g -Xmx2g
  

  注意：堆内存不要超过服务器物理内存的50%（比如服务器是8G内存，最多给ES分配4G），避免系统内存不足导致OOM。
• 保存后重启SonarQube服务，观察Dashboard是否恢复正常，同时监控日志是否还出现ES搜索错误。

2. 查看Elasticsearch的详细日志 #

SonarQube主日志里的错误信息比较笼统，你需要查看ES的专属日志来定位具体问题：

• 打开SONARQUBE_HOME/logs/elasticsearch.log，搜索ERROR或WARN关键词，看看是否有内存不足、分片未分配、索引损坏等具体报错。
• 也可以用curl命令直接检查ES集群和索引状态：

  # 查看所有索引的状态
  curl -XGET 'http://localhost:9001/_cat/indices?v'
  # 查看集群健康状态
  curl -XGET 'http://localhost:9001/_cluster/health?pretty'
  

  如果索引状态显示red（分片未分配）或yellow（副本未分配），可以尝试手动触发分片重新分配：

  curl -XPOST 'http://localhost:9001/_cluster/reroute?retry_failed=true'
  

3. 完整重建Elasticsearch索引（避免中途中断） #

之前你删除data/es文件夹重启后仅生效几分钟，大概率是因为索引重建过程被中断（比如同步数据时服务器负载过高、MySQL响应慢），导致后续索引再次损坏。

• 先停止SonarQube服务：

  sudo systemctl stop sonarqube
  

• 删除SONARQUBE_HOME/data/es整个文件夹：

  rm -rf SONARQUBE_HOME/data/es
  

• 启动SonarQube，然后不要操作任何项目或Dashboard，等待索引完全同步完成。你可以通过SONARQUBE_HOME/logs/sonar.log查看进度，当看到类似Indexing of issues completed的日志时，再去测试Dashboard的Issues标签。

4. 调整系统文件描述符限制 #

Elasticsearch需要大量的文件描述符来处理索引文件，Ubuntu 16.04默认的文件描述符限制（通常是1024）远远不够，这会导致ES无法正常读写索引，进而出现搜索失败。

• 编辑/etc/security/limits.conf文件，添加以下内容（假设SonarQube运行用户是sonarqube）：

  sonarqube soft nofile 65536
  sonarqube hard nofile 65536
  

• 保存后重启服务器，或者让sonarqube用户重新登录，用ulimit -n命令检查是否生效（输出应为65536）。

5. 考虑版本兼容性与升级 #

SonarQube 5.6.7是2017年的老版本，官方早已停止支持，虽然官方声称兼容MySQL 5.7，但可能存在一些未修复的bug，尤其是在大数据量场景下。如果上面的步骤都无法解决问题，建议：

• 先备份MySQL数据库和SonarQube的data文件夹：

  # 备份MySQL Sonar库
  mysqldump -u your_mysql_user -p sonar > sonar_backup_$(date +%Y%m%d).sql
  # 备份SonarQube data文件夹
  tar -czf sonar_data_backup_$(date +%Y%m%d).tar.gz SONARQUBE_HOME/data
  

• 升级到官方支持的LTS版本（比如7.9.x或8.9.x），这些版本对ES的稳定性和大数据量的支持更好，也修复了很多老版本的bug。

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