解决Spring Boot Gradle项目启动失败：端口8080已被占用

解决Spring Boot Gradle项目启动失败：端口8080已被占用

当您在使用./gradlew bootRun命令启动Spring Boot Gradle项目时，可能会遇到如下错误：

APPLICATION FAILED TO START  Description:  Web server failed to start. Port 8080 was already in use.  Action:  Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.  > Task :bootRun FAILED  FAILURE: Build failed with an exception.

这表明端口8080已被其他进程占用，导致Spring Boot应用无法正常启动。要解决这个问题，需要识别并终止占用该端口的进程，或者将Spring Boot应用配置为使用其他端口。

1. 查找占用端口的进程

首先，需要确定哪个进程正在使用端口8080。根据您使用的操作系统，可以使用不同的命令来查找：

Windows:

在命令提示符或PowerShell中运行以下命令：

netstat -aon | findstr 8080

该命令会列出所有正在使用端口8080的进程，并显示它们的PID（进程ID）。

Unix/Linux/Mac:

在终端中运行以下命令：

lsof -i :8080

或者

netstat -tulnp | grep 8080

lsof 命令会列出所有打开指定端口的进程，包括进程名称和PID。netstat 命令也能达到类似的效果。

2. 终止占用端口的进程

找到占用端口的进程PID后，就可以终止该进程了。

Windows:

1. 打开任务管理器（Ctrl+Shift+Esc）。
2. 切换到“详细信息”选项卡。
3. 找到PID与占用端口进程PID相同的进程。
4. 右键单击该进程，选择“结束进程”。

或者，可以使用taskkill命令在命令行中终止进程：

taskkill /F /PID <PID>

将替换为实际的进程ID。

Unix/Linux/Mac:

可以使用kill命令终止进程：

kill <PID>

将替换为实际的进程ID。 如果普通kill命令无法结束进程，可以尝试使用kill -9 强制终止进程。

3. 备选方案：配置Spring Boot应用使用其他端口

如果无法终止占用端口的进程，或者希望避免将来再次遇到相同的问题，可以将Spring Boot应用配置为使用其他端口。

在application.properties或application.yml文件中，添加或修改以下属性：

application.properties:

server.port=8081

application.yml:

server:   port: 8081

将8081替换为您希望使用的端口号。确保该端口未被其他进程占用。

4. 总结

解决Spring Boot Gradle项目启动时端口被占用的问题，关键在于：

1. 识别占用端口的进程： 使用netstat (Windows) 或 lsof/netstat (Unix/Linux/Mac) 命令。
2. 终止占用端口的进程： 使用任务管理器或taskkill (Windows) 或 kill (Unix/Linux/Mac) 命令。
3. 配置Spring Boot应用使用其他端口： 修改application.properties或application.yml文件。

通过以上步骤，您应该能够成功解决Spring Boot Gradle项目启动失败的问题，并确保应用正常运行。请记住，在开发过程中，经常检查端口占用情况是一个好习惯，可以避免不必要的麻烦。