Spring Boot应用端口占用问题的诊断与解决

理解Spring Boot端口占用错误

spring boot应用在默认情况下会启动一个内嵌的web服务器（如tomcat），并监听8080端口。当您尝试启动一个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

这个错误明确指出问题在于8080端口已被占用。值得注意的是，即使您尝试使用系统命令（如lsof -i :8080或netstat -ano | findstr :8080）来查找占用该端口的进程，有时也可能得到空结果。这尤其在集成开发环境（IDE）如IntelliJ IDEA中更为常见，因为IDE内部的进程管理机制可能导致系统层面的命令无法立即识别到冲突。

诊断IntelliJ IDEA中的端口占用

在IntelliJ IDEA中，最常见的端口占用原因并非来自外部应用，而是IDE内部上一次未完全终止的Spring Boot应用实例。当开发者停止一个应用时，有时进程可能并未完全退出，或者在短时间内再次启动，导致前一个实例的端口尚未及时释放。

排查步骤：

1. 打开IntelliJ IDEA的Services（服务）窗口。 这个窗口通常位于IDE的左下角或右下角。
2. 查找正在运行或僵尸状态的应用实例。 在Services窗口中，仔细检查是否有之前启动的、与当前应用名称相同或类似的Spring Boot应用实例仍在运行或处于僵尸状态。这些实例通常会显示其日志输出。
3. 识别冲突源。 如果发现有正在运行的实例，这很可能是导致当前应用启动失败的端口占用根源。

解决方案一：终止冲突进程

一旦在IntelliJ IDEA的Services窗口中识别出占用端口的冲突进程，最直接的解决方案就是将其终止。

操作步骤：

AppMall应用商店

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

56

查看详情

1. 在Services窗口中，选中仍在运行的Spring Boot应用实例。
2. 点击工具栏上的“停止”按钮（通常是一个红色的方块图标）。
3. 确认该实例已完全停止，其日志输出不再更新，并且状态变为“已停止”。
4. 之后，尝试重新启动当前Spring Boot应用。

解决方案二：修改应用服务端口

如果无法找到或终止冲突进程，或者希望为应用配置一个固定的备用端口以避免未来的冲突，可以通过修改Spring Boot的配置文件来实现。

操作步骤：

1. 定位配置文件。 在您的Spring Boot项目的src/main/resources目录下，找到或创建application.properties文件（如果您使用YAML格式，则是application.yml）。

2. 添加或修改端口配置。 在该文件中，添加或修改以下配置项，将服务端口更改为其他未被占用的端口，例如8089：

   对于application.properties：

   # application.properties
   server.port=8089

   登录后复制

   对于application.yml：

   # application.yml
   server:
     port: 8089

   登录后复制

3. 保存并重新启动。 保存文件后，重新构建并运行Spring Boot应用。应用将尝试在指定的新端口上启动。

注意事项

• 端口选择： 确保选择的端口号未被其他重要服务占用。常见的备用端口包括8081、8082、8089等。避免使用0-1023的系统保留端口。
• 配置文件优先级： Spring Boot支持多种配置文件格式和位置，application.properties（或.yml）是默认且常用的配置方式。如果存在多个配置文件（如application-dev.properties），请确保您修改的是当前激活的配置文件。
• 生产环境考量： 在生产环境中，通常会使用反向代理（如Nginx、Apache HTTP Server）将外部请求转发到Spring Boot应用的不同端口，或者直接使用标准端口（如80/443）。直接暴露非标准端口可能不常见。
• IDE缓存： 有时IDE的缓存可能导致配置不立即生效。如果修改端口后问题依旧，可以尝试清理项目（Build -> Rebuild Project）并重新构建。
• 操作系统进程： 如果IDE内部没有发现冲突进程，但端口仍然被占用，您可能需要使用操作系统的工具（如Windows的netstat -ano和taskkill /PID，Linux/macOS的lsof -i :端口号和kill -9 PID）来查找并终止占用端口的外部进程。

总结

Spring Boot应用在启动时遇到端口占用是开发过程中常见的问题。在IntelliJ IDEA这样的集成开发环境中，首先应检查其内置的Services窗口，确认没有僵尸进程占用端口。此外，通过修改application.properties（或application.yml）中的server.port属性是解决端口冲突的有效且灵活的方法。理解并掌握这些诊断和解决技巧，能够帮助开发者快速定位并解决应用启动问题，从而提高开发效率。

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