WSL2与Windows端口转发后出现address already in use错误求助

核心原因 #

你遇到的冲突是因为netsh interface portproxy规则设置为监听0.0.0.0:27017（全网卡端口），导致Windows系统进程svchost占用了该端口，进而与WSL中Docker、FastAPI的端口绑定/映射请求冲突。手动杀死svchost会破坏Windows端口转发服务，自然导致转发失效。

解决步骤 #

1. 清理冲突的端口转发规则

打开管理员权限PowerShell，先查看所有现有转发规则：

netsh interface portproxy show all

找到ListenPort为27017的规则，执行删除命令：

netsh interface portproxy delete v4tov4 listenport=27017 listenaddress=0.0.0.0

2. 重新创建不冲突的转发规则

调整规则为仅监听Windows的局域网IP（而非全网卡），既保留局域网访问能力，又不占用全局端口：

• 先获取WSL2的内部IP：

$wslIp = wsl hostname -I | ForEach-Object { $_.Split()[0] }

• 获取Windows的局域网网卡IP（将Wi-Fi替换为你的实际网卡名称，如以太网）：

$winIp = (Get-NetIPAddress -AddressFamily IPv4 -InterfaceAlias "Wi-Fi" | Select-Object -First 1).IPAddress

• 创建定向转发规则：

netsh interface portproxy add v4tov4 listenaddress=$winIp listenport=27017 connectaddress=$wslIp connectport=27017

3. 验证规则与服务状态

• 确认新规则生效：

netsh interface portproxy show all

此时ListenAddress应为你的Windows局域网IP，而非0.0.0.0。

• 启动WSL中的Docker、FastAPI服务，此时不会再出现address already in use错误，外部设备通过Windows局域网IP:27017即可访问WSL内的服务。

额外提示 #

• 不要手动杀死svchost进程：它是Windows负责端口转发的系统进程，强制终止会导致整个端口转发服务瘫痪。
• 本地访问优化：如果仅需本地访问WSL服务，可将转发规则的listenaddress设为127.0.0.1，进一步避免端口冲突。

内容的提问来源于stack exchange，提问作者MrTrillion