当您在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）已经被系统上的另一个进程占用。尽管操作系统级别的工具（如 lsof -i :8080）有时可能无法立即显示占用该端口的进程，但在开发环境中，尤其是使用集成开发环境（IDE）如IntelliJ IDEA时，最常见的原因往往是应用程序的上一个实例未能完全终止，其进程仍在后台运行。
排查与解决策略解决端口占用问题通常有以下几种有效策略。
1. 检查 IntelliJ IDEA 的服务视图这是在IntelliJ IDEA中遇到此问题时最直接、最常见的原因及解决方案。IntelliJ IDEA有一个强大的“Services”工具窗口，它会显示当前正在运行或最近运行的应用程序实例及其日志。
操作步骤：
- 打开IntelliJ IDEA。
- 在屏幕底部或侧边栏找到并点击“Services”工具窗口（通常是一个形似“播放”按钮的图标）。
- 在“Services”视图中，查找您的Spring Boot应用程序的实例。您可能会看到一个或多个正在运行或处于“已停止”但未完全清理状态的实例。
- 如果发现有正在运行的相同应用程序实例，选中它。
- 点击工具栏上的“Stop”按钮（红色方块图标）来终止该进程。
- 确认进程已完全停止后，尝试重新启动您的Spring Boot应用程序。
通常，这种方法能解决大部分由IDE内残留进程引起的端口占用问题。
2. 修改应用程序的监听端口如果无法找到或终止占用端口的进程，或者您希望您的应用程序在不同的端口上运行，可以通过修改Spring Boot的配置来更改监听端口。
操作步骤：
打开您的Spring Boot项目的 src/main/resources 目录下的 application.properties 或 application.yml 文件。
-
在文件中添加或修改 server.port 属性。
对于 application.properties：
HyperWrite
AI写作助手帮助你创作内容更自信
54
查看详情
server.port=8089
对于 application.yml：
server: port: 8089
这里，我们将端口更改为8089。您可以选择任何未被占用的端口（例如8081、9000等）。
保存文件。
重新启动您的Spring Boot应用程序。
注意事项： 更改端口后，访问应用程序的URL时需要使用新的端口号，例如 http://localhost:8089。
3. 手动识别并终止外部进程如果上述方法无效，或者您怀疑是IntelliJ IDEA外部的某个进程占用了端口，您需要使用操作系统工具来识别并终止它。
操作步骤：
-
识别占用端口的进程ID (PID)：
- Linux/macOS: 打开终端，运行 sudo lsof -i :8080 或 sudo netstat -tulnp | grep 8080。lsof 命令通常更详细，会显示进程名称和PID。
- Windows: 打开命令提示符（以管理员身份运行），运行 netstat -ano | findstr :8080。这会显示占用8080端口的TCP连接及其对应的PID。
-
终止进程：
- Linux/macOS: 获得PID后，运行 kill -9 <PID>。例如，如果PID是12345，则运行 kill -9 12345。
- Windows: 获得PID后，打开任务管理器，切换到“详细信息”选项卡，找到对应的PID，右键点击并选择“结束任务”。或者在命令提示符中运行 taskkill /F /PID <PID>。
警告： 在终止任何进程之前，请务必确认该进程不是关键的系统服务或其他重要应用程序。
总结当Spring Boot应用在IntelliJ IDEA中启动时遇到“端口占用”错误，首要的排查步骤是检查IntelliJ IDEA的“Services”工具窗口，终止任何残留的应用程序实例。如果问题依然存在，或希望使用不同端口，修改 application.properties 中的 server.port 属性是简单有效的解决方案。在极端情况下，才需要诉诸操作系统级别的命令来识别和终止占用端口的外部进程。通过这些方法，您可以有效地解决Spring Boot应用启动时的端口冲突问题，确保开发流程的顺畅。
以上就是Spring Boot 应用启动失败：端口占用问题的排查与解决的详细内容，更多请关注知识资源分享宝库其它相关文章！
相关标签： linux windows idea 操作系统 app 端口 工具 mac ai macos win 开发环境 spring spring boot windows ide macos idea intellij idea http linux 大家都在看： 在Java应用中高效管理大规模Linux命令执行 在Java中高效管理与执行大量Linux命令 Java应用中高效运行和管理大量Linux命令的策略 将Java应用部署为Linux服务：理解内核与用户空间 如何将Java应用程序作为Linux系统服务运行
发表评论:
◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。