Spring Boot 启动提示端口被占用但找不到占用进程（WSL mirrored 导致） - Higurashi

问题现象

• 启动 Spring Boot 报错：Port 48080 was already in use
• 但netstat/docker ps看不到明显进程占用48080
• 后续又出现：MySQL/Redis 连接失败（CommunicationsException、Connection refused）

关键定位过程

1. 先排除常规占用

• docker ps确认容器端口映射正常
• netstat未发现对应端口监听

2. 用绑定测试验证“是否真能占用端口”

• 通过TcpListener实测发现：47000-48715整段不可绑定
• 48080/48081正好落在该区间

3. 检查 WSL/HNS 网络状态

• .wslconfig使用了networkingMode=mirrored
• hns、vmcompute处于运行状态
• Get-HnsNetwork显示大量Type: Mirrored网络

根因

在WSL mirrored+ HNS场景下，系统网络层会占用/保留一段端口。
这类占用不一定表现为普通用户态进程监听，所以会出现“报端口占用，但查不到进程”的现象。

解决方案

1. 将C:\Users\<用户名>\.wslconfig改为：

[wsl2]
networkingMode=nat

2. 执行：

wsl --shutdown

3. 重启 Docker Desktop（必要时重启电脑）
4. 重新验证48080可绑定后再启动项目

本次附带问题与处理

切换网络模式后曾出现回环链路不一致：

• 127.0.0.1:33306/36379不通
• ::1:33306/36379可通

临时处理：应用配置改为::1。
重启后 IPv4 恢复，再切回127.0.0.1。

最小复盘清单（推荐保留）

# 1) 看容器与端口映射
docker ps# 2) 看端口是否可绑定（比 netstat 更直接）
# 可用自定义 TcpListener 小脚本快速验证# 3) 看 WSL 模式
Get-Content $env:USERPROFILE\.wslconfig# 4) 切换后使配置生效
wsl --shutdown

结论：这类“端口占用但查不到进程”优先怀疑系统虚拟网络层，而不只是应用进程本身。