Sonar是一款非常重要的代码质量检测工具。然而，在Windows环境下安装Sonar 7.7版本可能会遇到一些意想不到的问题。本文将详细介绍安装步骤，并结合实际安装过程中遇到的一个大坑来帮助大家顺利完成安装。

一、安装步骤

（一）准备工作

1. 系统要求检查

  • 确保你的Windows系统有足够的磁盘空间和内存来支持Sonar的运行。一般来说，至少要有2GB的可用磁盘空间和2GB以上的内存。 2. 安装依赖软件
  • Java环境：Sonar运行需要Java。从Oracle官网下载并安装适合你系统的JDK（Java Development Kit）版本，安装完成后记得配置好系统环境变量，确保在命令行中可以运行 java -version 命令并得到正确的版本信息。
  • 数据库：Sonar支持多种数据库，如MySQL、PostgreSQL等。这里以MySQL为例。
  • 从MySQL官网下载并安装MySQL Community Server。
  • 在安装过程中，设置好root用户的密码，并记住它。安装完成后，启动MySQL服务。

（二）Sonar安装

1. 下载安装包

从Sonar官方网站下载Sonar 7.7版本的Windows安装包。下载完成后，将其解压到你选择的安装目录，例如 C:\sonarqube - 7.7 。

2. 配置数据库连接

  • 进入 C:\sonarqube - 7.7\conf 目录，找到 sonar - properties 文件。
  • 打开文件，找到数据库配置部分。如果使用MySQL，配置如下： 
sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance
sonar.jdbc.username=root
sonar.jdbc.password=your_mysql_password

其中 your_mysql_password 是你在安装MySQL时设置的root用户密码。这里的数据库名 sonar 是关键，这也是我们在排错过程中发现的重要点。

3. 配置Elasticsearch（可选）

Sonar使用Elasticsearch进行数据存储和搜索。如果你的系统资源允许，你可以在 C:\sonarqube - 7.7\conf\sonar - search - properties 文件中调整Elasticsearch的配置参数，如内存大小等。例如，你可以适当增加  - Xmx 和  - Xms 参数的值来提升Elasticsearch的性能，但要注意不要超过系统可用内存。

（三）启动Sonar

1. 找到启动脚本

  • 在 C:\sonarqube - 7.7\bin 目录下，根据你的Windows系统是32位还是64位，选择相应的启动脚本。例如，对于64位系统，选择 StartSonar.bat 文件。 2. 启动服务
  • 双击 StartSonar.bat 文件，启动Sonar服务。此时，Sonar会开始初始化并尝试连接数据库和启动Elasticsearch。

二、排错之旅

（一）问题描述

在安装Sonar 7.7的过程中，遇到了令人头疼的启动错误。启动过程中不断出现远程连接关闭的错误提示，错误信息如下：

Windows环境下Sonar 7.7安装避大坑看过不后悔_MySQL

（二）排查过程

1. 数据库连接排查

  • 首先怀疑是数据库连接问题。于是检查了数据库的配置，包括数据库的IP地址、端口号、用户名和密码。
  • 使用MySQL客户端工具尝试连接数据库，发现数据库连接是正常的，并且可以使用配置文件中的用户名和密码登录。

2. Elasticsearch排查

  • 由于Sonar依赖Elasticsearch，接下来怀疑是Elasticsearch没有正常启动或无法连接。
  • 查看Elasticsearch的日志文件（通常在Elasticsearch的安装目录下的 logs 目录中），发现没有明显的错误提示，但为了保险起见，还是尝试调整了Elasticsearch的内存配置。在 C:\sonarqube - 7.7\conf\elasticsearch.yml 文件中增加了堆内存大小，例如：
  • Xmx4g
  • Xms4g
  • 然而，即使调整了Elasticsearch的内存配置，问题依旧存在。

（三）问题解决

经过反复排查，终于在Sonar的配置文件的注释中发现了端倪。在 sonar - properties 文件中，数据库连接的配置部分有一个容易被忽视的细节：数据库名。原来配置中的数据库名如果不正确，会导致Sonar无法正常启动。

当把数据库名修改为 sonar （与创建的数据库名一致）后，再次启动Sonar，成功启动，没有报错。

三、总结

在Windows环境下安装Sonar 7.7版本需要仔细地配置每一个环节，特别是数据库连接和相关依赖软件的配置。遇到问题时不要慌张，按照从数据库连接到依赖软件的顺序逐步排查，往往能找到问题的根源并解决它。希望本文能够帮助你顺利安装Sonar 7.7，让你在代码质量检测的道路上更加顺畅。