BindException: Address already in use需先查端口占用:Windows用netstat -ano | findstr :端口,macOS/Linux用lsof -i :端口;若为Cannot assign requested address,则检查IP绑定是否错误,如硬编码不存在IP,应改用0.0.0.0或localhost。

BindException: Address already in use 怎么快速定位端口占用
这个错误八成是另一个进程正占着你要启动的服务端口。别急着改代码,先查系统里谁在用它。
- Windows 上跑
netstat -ano | findstr :8080(把8080换成你报错的实际端口),记下 PID,再用任务管理器搜 PID 找进程 - macOS / Linux 用
lsof -i :8080或sudo netstat -tulpn | grep :8080 - Java 进程常被忽略:比如上一次调试没关干净的 Spring Boot 实例,或者 IDE 里残留的 Run Configuration
BindException: Cannot assign requested address 是 IP 配置错了
不是端口问题,是 Java 尝试绑定一个本机根本不存在或不可用的 IP 地址,比如绑了 192.168.5.100 但网卡实际只有 192.168.1.x 段。
- 检查代码里是否硬编码了
bind()的地址,例如new InetSocketAddress("192.168.5.100", 8080)—— 改成"0.0.0.0"或"localhost"先验证 - Spring Boot 用户注意
server.address配置项:设成不存在的内网 IP 会直接触发这个异常,留空或设为127.0.0.1更稳妥 - Docker 环境下还要确认 host 网络模式、端口映射规则,容器内 bind
0.0.0.0不等于宿主机能访问到
Java NIO 和传统 ServerSocket 的 bind 行为差异
同一个端口,ServerSocket 和 ServerSocketChannel 对 SO_REUSEADDR 的默认处理不同,容易误判“端口没被占却还报错”。
-
ServerSocket默认不开启SO_REUSEADDR,所以 TIME_WAIT 状态的连接会阻塞新绑定;手动调setReuseAddress(true)可缓解 -
ServerSocketChannel在大多数 JDK 版本中默认启用该选项,但某些旧版 Android 或嵌入式 JVM 可能不一致 - 别依赖“刚 kill 掉进程就立刻重启成功”,TCP 四次挥手中的 TIME_WAIT 至少持续 2MSL(通常 60–120 秒)
IDE 调试时反复触发 BindException 的隐藏原因
不是代码问题,是开发环境自身造成的伪冲突:IDE 启动多个实例、热部署未清理旧监听、Maven/Gradle 并行构建触发重复绑定。
立即学习“Java免费学习笔记(深入)”;
- IntelliJ IDEA:检查
Run → Edit Configurations → Allow parallel run是否勾选,勾了就可能两个 Spring Boot 实例同时抢8080 - Spring DevTools:默认启用 LiveReload,但某些配置下会悄悄启动第二个嵌入式容器,看日志里有没有两行
Tomcat started on port(s): 8080 - Maven 多模块项目:如果父 POM 里有
spring-boot-maven-plugin,又在子模块里重复配置,打包时可能意外启动服务
真正麻烦的是那种“只在客户机器上复现,本地一切正常”的情况——大概率是目标环境防火墙策略、SELinux 限制、或容器网络命名空间隔离导致的地址不可达,这时候 BindException 的错误信息不会告诉你这些,得靠 ss -tuln 和 getenforce 一层层筛。










