SonarQube安装配置 SonarQube安装插件后重启后启动不了

品牌型号：联想 E550C ThinkPad

系统：Windows 11

软件版本：SonarQube Server 25

SonarQube作为开源的代码质量管理分析工具，以其强大的静态代码分析能力广受欢迎，但初次接触的新手可能发现，其安装配置存在一定难度，需要按照多个步骤操作。因此，本文将专注于帮助大家解决SonarQube安装配置，SonarQube安装插件后重启后启动不了的问题，通过步骤演示，协助大家顺利搭建稳定的SonarQube服务环境。

一、SonarQube安装配置

在开始使用SonarQube之前，首先需要顺利安装该软件并启动服务，以下是具体的安装配置步骤：

1、下载安装包。前往SonarQube网站，点击下载菜单进入下载界面，下载界面提供4个版本：社区版、开发者版、企业版和数据中心版，可以根据页面介绍的功能和使用场景选择对应的安装包进行下载。

2、安装Java服务。SonarQube依赖Java运行环境，建议使用Java17或Java21，可以访问“https://adoptium.net/en-GB/temurin/releases/?version=21”，找到匹配当前操作系统的Java 21版本MSI安装包下载安装。

3、将SonarQube目录添加到系统PATH目录中。打开系统环境变量窗口，选中系统变量的PATH变量，点击编辑按钮进入编辑环境变量界面，点击新建按钮，将SonarQube安装目录的bin目录绝对路径添加到变量中，如图所示。

4、启动SonarQube服务。在SonarQube安装文件夹的bin目录下，有多个以操作系统命名的文件夹，如“windows-x86-64”文件夹，它们分别包含各自操作系统的SonarQube启动文件。

在Windows系统中，我们打开系统终端界面，输入“.\StartSonar.bat”命令，就可以启动SonarQube服务，浏览器如果能够访问“Iocalhost:900”即可使用。

二、SonarQube安装插件后重启后启动不了

SonarQube的强大很大程度上依赖于其丰富的插件生态系统，如果插件安装不当，可能导致服务无法启动，可以按以下步骤排查解决：

1、插件安装时可能下载出错导致未完全下载，我们可以打开SonarQube的文件夹，在“extensions”文件夹中，删除“downloads”和“plugins”目录下未完全下载的插件文件。

2、部分插件可能需要较大的内存空间方能启动，打开conf文件夹，打开“sonar.properties”文件，修改“sonar.web.javaOpts”的配置，其中Xmx对应最大内存，Xms对应最小内存，适当调大内存以支持插件运行。

上文重点讲解了SonarQube安装配置，SonarQube安装插件后重启后启动不了的问题，当前官方支持Linux、MacOS和Windows三大主流操作系统，但由于系统不同，它们之间的安装配置和启动方式也有所区别，如果要实现跨系统安装，大家也可以采用docker容器化的方式进行安装部署。而SonarQube网页端还提供了官方插件下载途径，也建议大家从上面下载，从而避免出现插件无法使用的情况。