解决 Spring Boot Gradle 项目启动时端口 8080 冲突问题

本文旨在帮助开发者解决 Spring Boot Gradle 项目启动时遇到的端口 8080 冲突问题。通过本文，你将学会如何识别占用 8080 端口的进程，并采取相应措施，例如终止该进程或配置 Spring Boot 应用使用其他端口，从而成功启动你的 Spring Boot 应用。

当你在使用 Gradle 构建的 Spring Boot 项目中运行 ./gradlew bootRun 命令时，如果遇到类似 “Web server failed to start. Port 8080 was already in use.” 的错误信息，这通常意味着你的电脑上已经有其他进程占用了 8080 端口，导致 Spring Boot 应用无法启动。以下是解决此问题的步骤：

1. 查找占用 8080 端口的进程

首先，我们需要确定哪个进程占用了 8080 端口。不同的操作系统有不同的命令可以用来查找：

• Windows:

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

  netstat -aon | findstr 8080

  该命令会列出所有使用 8080 端口的连接，并显示对应的进程 ID (PID)。

• Unix/Linux/Mac:

  在终端中运行以下命令：

  lsof -i :8080

  该命令会列出占用 8080 端口的进程信息，包括进程的 PID。

2. 终止占用 8080 端口的进程

找到占用 8080 端口的进程 ID 后，你可以选择终止该进程。

• Windows:

  可以使用 taskkill 命令，例如：

  taskkill /F /PID <PID>

  将 替换为实际的进程 ID。 也可以使用任务管理器，在“详细信息”选项卡中找到对应的 PID，然后结束该进程。

• Unix/Linux/Mac:

  可以使用 kill 命令，例如：

  kill <PID>

  将 替换为实际的进程 ID。 如果进程无法正常终止，可以使用 kill -9 强制终止。

3. 配置 Spring Boot 应用使用其他端口

如果你不想终止占用 8080 端口的进程，或者你希望 Spring Boot 应用始终使用不同的端口，你可以通过配置 application.properties 或 application.yml 文件来更改 Spring Boot 应用的端口。

在 application.properties 文件中添加以下配置：

server.port=8081

或者在 application.yml 文件中添加以下配置：

server:   port: 8081

将 8081 替换为你想要使用的端口号。

示例：application.properties

spring.application.name=my-spring-boot-app server.port=8081

注意事项:

• 确保选择一个未被其他应用程序占用的端口。
• 如果你的 Spring Boot 应用使用了安全协议 (HTTPS)，还需要配置 server.ssl.key-store 和 server.ssl.key-store-password 等相关属性。

总结

端口冲突是开发过程中常见的问题。通过本文提供的步骤，你可以轻松地找到并解决 Spring Boot Gradle 项目启动时遇到的端口 8080 冲突问题。 记住，在终止进程之前，请确认该进程是否可以安全终止，以免影响其他应用程序的正常运行。 如果不想终止现有进程，可以灵活地配置 Spring Boot 应用使用不同的端口。