SpringBoot 应用启动失败：端口 8080 已被占用解决方案

本文将指导你如何解决 Spring Boot 项目在使用 Gradle 启动时，遇到的端口占用问题。 这个问题通常表现为错误信息 “Web server failed to start. Port 8080 was already in use.”，导致应用启动失败。

确定端口占用情况

当 Spring Boot 应用尝试启动时，如果指定的端口（默认是 8080）已经被其他进程占用，就会出现启动失败的情况。 要解决这个问题，首先需要确定哪个进程占用了该端口。 不同的操作系统有不同的命令可以用来查看端口占用情况。

Windows 系统

在 Windows 系统中，可以使用 netstat 命令来查找占用特定端口的进程。 打开命令提示符（CMD）或 PowerShell，然后执行以下命令：

netstat -aon | findstr 8080

这个命令会列出所有正在监听的端口，并通过 findstr 过滤出包含 8080 的行。 输出结果会显示占用 8080 端口的进程的 PID (Process Identifier)。

Unix/Linux/Mac 系统

在 Unix/Linux/Mac 系统中，可以使用 lsof 命令来查找占用特定端口的进程。 打开终端，然后执行以下命令：

lsof -i :8080

这个命令会列出所有占用 8080 端口的进程的详细信息，包括进程的 PID。

解决端口占用问题

一旦确定了占用 8080 端口的进程的 PID，就可以采取以下两种方法来解决问题：

1. 停止占用端口的进程

这是最直接的解决方法。 根据不同的操作系统，可以使用不同的命令或工具来停止进程。

• Windows: 可以使用任务管理器（Task Manager）或 taskkill 命令。 在任务管理器中，找到对应的 PID 的进程，然后结束该进程。 或者，在命令提示符中使用以下命令：

  taskkill /F /PID <PID>

  将 替换为实际的进程 ID。

• Unix/Linux/Mac: 可以使用 kill 命令。 在终端中使用以下命令：

  kill <PID>

  将 替换为实际的进程 ID。

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

如果无法停止占用端口的进程，或者希望避免将来再次出现端口冲突，可以配置 Spring Boot 应用使用其他端口。

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

server.port=8081

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

注意事项

• 在停止进程之前，请确保了解该进程的作用，避免误杀重要进程。
• 如果修改了 Spring Boot 应用的端口，需要相应地修改访问应用的 URL。
• 如果在使用 Docker 容器运行 Spring Boot 应用，需要确保容器的端口映射配置正确。

总结

端口占用是 Spring Boot 应用启动时常见的错误。 通过使用 netstat (Windows) 或 lsof (Unix/Linux/Mac) 命令，可以快速定位占用端口的进程，并采取相应措施（如停止该进程或配置 Spring Boot 应用使用其他端口）来解决启动失败的问题。 理解并掌握这些方法，可以有效地解决 Spring Boot 应用开发中遇到的端口冲突问题。