本文针对Spring Boot应用在IntelliJ IDEA中启动时常见的端口占用问题（特别是8080端口）提供了详细的诊断与解决方案。内容涵盖了如何排查IntelliJ IDEA内部可能存在的僵尸进程，以及通过修改application.properties文件来重新配置服务端口，确保应用顺利启动。
理解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应用实例。当开发者停止一个应用时，有时进程可能并未完全退出，或者在短时间内再次启动，导致前一个实例的端口尚未及时释放。
排查步骤：
打开IntelliJ IDEA的Services（服务）窗口。 这个窗口通常位于IDE的左下角或右下角。查找正在运行或僵尸状态的应用实例。 在Services窗口中，仔细检查是否有之前启动的、与当前应用名称相同或类似的Spring Boot应用实例仍在运行或处于僵尸状态。这些实例通常会显示其日志输出。识别冲突源。 如果发现有正在运行的实例，这很可能是导致当前应用启动失败的端口占用根源。
解决方案一：终止冲突进程
一旦在IntelliJ IDEA的Services窗口中识别出占用端口的冲突进程，最直接的解决方案就是将其终止。
操作步骤：
AppMall应用商店
AI应用商店，提供即时交付、按需付费的人工智能应用服务
56 查看详情 
在Services窗口中，选中仍在运行的Spring Boot应用实例。点击工具栏上的“停止”按钮（通常是一个红色的方块图标）。确认该实例已完全停止，其日志输出不再更新，并且状态变为“已停止”。之后，尝试重新启动当前Spring Boot应用。
解决方案二：修改应用服务端口
如果无法找到或终止冲突进程，或者希望为应用配置一个固定的备用端口以避免未来的冲突，可以通过修改Spring Boot的配置文件来实现。
操作步骤：
定位配置文件。 在您的Spring Boot项目的src/main/resources目录下，找到或创建application.properties文件（如果您使用YAML格式，则是application.yml）。
添加或修改端口配置。 在该文件中，添加或修改以下配置项，将服务端口更改为其他未被占用的端口，例如8089：
对于application.properties：
# application.propertiesserver.port=8089
对于application.yml：
# application.ymlserver: port: 8089
保存并重新启动。 保存文件后，重新构建并运行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应用端口占用问题的诊断与解决的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/330552.html
微信扫一扫 
支付宝扫一扫 
