You need to enable JavaScript to run this app. Spring Boot启动报端口被占用但应用实际正常运行问题求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 06:36:04