Spring Boot启动报端口被占用但应用实际正常运行问题求助
Spring Boot启动报端口占用但应用可正常访问的排查方案
你遇到的这种报错但应用实际可访问的情况,本质是web服务器初始化过程中,有两次绑定同一端口的操作,第一次绑定成功应用可正常运行,第二次绑定失败抛出端口占用异常,按照以下步骤逐一排查即可:
1. 检查是否重复启动应用
启动报错后先执行端口占用查询命令,确认是否有多个进程占用同一端口:
- Windows系统执行:
netstat -ano | findstr <你的端口号> - Linux/macOS系统执行:
lsof -i :<你的端口号>
如果查询结果返回了2个不同的PID,说明你同时启动了两次应用,把多余的进程杀掉后重启即可。
额外检查IDE启动配置:确认你使用的IDEA/Eclipse等IDE的启动选项中,没有勾选「允许并行运行/Allow parallel run」,避免多次点击启动按钮触发多实例运行。
2. 检查是否代码中手动配置了重复的Tomcat连接器
很多人为了同时支持HTTP和HTTPS,会在代码中手动新增Tomcat连接器,如果不小心把新增连接器的端口和配置文件里的server.port设为同一个值,就会触发端口冲突:
请排查你的项目中是否存在类似如下的配置代码:
@Bean public ServletWebServerFactory servletContainer() { TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory(); // 新增额外的连接器 tomcat.addAdditionalTomcatConnectors(createHttpConnector()); return tomcat; } private Connector createHttpConnector() { Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol"); // 此处端口如果和配置文件的server.port一致,就会冲突 connector.setPort(8443); return connector; }
如果有这类代码,要么把新增连接器的端口改为其他未被占用的端口,要么直接删除不需要的额外连接器配置即可解决问题。
3. 临时禁用spring-boot-devtools排查
你当前引入了devtools依赖,它的自动重启逻辑偶尔会出现首次启动误触发两次web服务器初始化的问题,可以先临时注释掉pom中的devtools依赖,重启项目验证问题是否消失:
<!-- <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> <optional>true</optional> </dependency> -->
如果禁用devtools后问题消失,可清空IDE的缓存和项目编译目录,再重新引入devtools即可恢复正常。
4. 修正SSL配置不匹配问题
你当前配置的server.ssl.key-store-type=pkcs12,但引用的证书文件后缀为jks,两种格式不匹配可能会触发web服务器初始化重试,导致端口绑定冲突:
- 如果你的证书确实是PKCS12格式,把证书文件名改为
certificate.p12 - 如果你的证书是JKS格式,把配置项改为
server.ssl.key-store-type=JKS
修正后重启项目验证即可。
内容的提问来源于stack exchange,提问作者lisa
相关产品推荐
相关产品推荐

