port-in-use

端口被占用的定位与修复

现象

服务启动报 Address already in use、bind: address already in use，或无法监听指定端口。常见于旧进程未退出、另一个服务抢占或容器端口映射冲突。

快速定位

ss -lntp | grep ':<port>'
lsof -i :<port>
fuser -n tcp <port>
ps -p <pid> -o pid,ppid,comm,args
systemctl status <service>
docker ps --format '{{.Names}}\t{{.Ports}}'

常见根因

1. 旧进程没有正常退出，仍在监听。
2. 另一个服务或子进程占用了同一端口。
3. systemd socket activation 或守护进程自动拉起。
4. TIME_WAIT 大量存在，端口复用配置不当。
5. 容器端口映射到宿主机同一端口。
6. 只监听 IPv6 或特定地址，客户端连的却是另一个地址族。

修复

• 先用 ss -lntp 确认占用进程和监听地址，不要直接 kill -9。
• 旧进程能正常停止就 systemctl stop 或发 SIGTERM。
• 不能停的服务改用其他端口，并同步更新配置和防火墙。
• 容器冲突检查 -p 映射和 compose 端口。
• 需要快速重启时确认 SO_REUSEADDR，但不要依赖它掩盖泄漏。
• 检查 IPv4/IPv6 双栈监听差异。

相关命令

• ss — 监听端口
• lsof — 端口对应进程
• fuser — 按端口找进程
• docker — 容器端口映射