Spring Boot 应用启动失败：端口占用问题排查与解决

本文旨在帮助开发者解决 Spring Boot 应用在 IntelliJ IDEA 中启动时遇到的端口占用问题。通过分析错误信息，我们将引导你找到占用 8080 端口的进程，或者提供修改应用端口的解决方案，确保你的 Spring Boot 应用能够顺利启动。

在使用 IntelliJ IDEA 开发 Spring Boot 应用时，你可能会遇到类似如下的错误信息：

***************************
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.


Process finished with exit code 1

这表明你的 Spring Boot 应用尝试启动时，默认的 8080 端口已经被其他进程占用，导致应用启动失败。 解决这个问题通常有两种方法：找到并停止占用端口的进程，或者修改 Spring Boot 应用的端口配置。

方法一：查找并停止占用端口的进程

首先，我们需要确定哪个进程占用了 8080 端口。 虽然 lsof -i :8080 命令没有输出，但并不意味着没有进程占用该端口。 这可能是因为权限问题，或者该进程不是由当前用户启动的。

1. 使用 netstat 命令 (适用于 Linux/macOS/Windows):

netstat 是一个强大的网络工具，可以显示网络连接、路由表和网络接口信息。 使用以下命令可以查看占用 8080 端口的进程：

• Linux/macOS: sudo netstat -tulnp | grep 8080
• Windows: netstat -ano | findstr :8080

在 Linux/macOS 上，sudo 命令可能需要你输入管理员密码。 命令的输出会显示占用 8080 端口的进程的 PID (进程ID)。

2. 使用任务管理器 (适用于 Windows):

在 Windows 上，你也可以使用任务管理器来查找占用 8080 端口的进程。

• 打开任务管理器 (Ctrl + Shift + Esc)。
• 切换到 "详细信息" 选项卡。
• 找到 "PID" 列，如果没有，可以通过 "查看" -> "选择列" 来添加。
• 根据 netstat 命令找到的 PID，在任务管理器中找到对应的进程，然后结束该进程。

3. IntelliJ IDEA 的 Services 窗口:

一个常见的情况是，你之前可能已经在 IntelliJ IDEA 中启动了 Spring Boot 应用，但没有正确关闭。 IntelliJ IDEA 的 "Services" 窗口会显示正在运行的应用。 检查 "Services" 窗口，看看是否有之前启动的 Spring Boot 应用实例。 如果有，停止该实例。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

找到占用 8080 端口的进程后，你可以使用 kill <PID> 命令 (Linux/macOS) 或在任务管理器中结束进程 (Windows) 来停止该进程。 然后，重新启动你的 Spring Boot 应用。

方法二：修改 Spring Boot 应用的端口

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

1. 在 application.properties 或 application.yml 文件中配置:

在 src/main/resources 目录下，找到 application.properties 或 application.yml 文件。 如果没有，创建一个。 添加以下配置来修改端口：

• application.properties:

  server.port=8089

  登录后复制

• application.yml:

  server:
    port: 8089

  登录后复制

将 8089 替换为你想要使用的端口号。 确保选择一个未被其他应用占用的端口。

2. 重新启动应用:

保存配置文件后，重新启动你的 Spring Boot 应用。 应用现在应该在新的端口上运行。 你可以在浏览器中访问 http://localhost:8089 (如果你的应用提供了 Web 接口) 来验证应用是否成功启动。

注意事项

• 确保选择一个未被占用的端口。 常用的端口包括 8081、8082、8083 等。
• 如果你的 Spring Boot 应用部署在云服务器上，你需要确保防火墙允许访问你配置的端口。
• 如果你使用的是 Docker 容器，你需要将容器的端口映射到宿主机的端口。

总结

端口占用是 Spring Boot 应用启动时常见的错误。 通过本文提供的两种方法，你可以快速找到并解决端口占用问题，确保你的应用能够顺利启动。 建议优先尝试查找并停止占用端口的进程，如果无法解决，再考虑修改应用的端口配置。 在开发过程中，养成良好的习惯，及时关闭不再需要的应用实例，可以有效避免端口冲突。

以上就是Spring Boot 应用启动失败：端口占用问题排查与解决的详细内容，更多请关注php中文网其它相关文章！