问题描述#

在 Windows 上启动应用时报错：

1
Web server failed to start. Port 8080 was already in use.

但用 netstat -ano | findstr :8080 却没有任何输出，找不到占用进程。

根本原因： Windows 的 Hyper-V / WinNAT 服务会动态预留一批端口范围，被预留的端口无法被普通应用绑定，且不会出现在 netstat 结果中。

1
netsh interface ipv4 show excludedportrange protocol=tcp

1
开始端口    结束端口
2
----------  --------
3
      8001      8100   ← 8080 在此范围内，无法使用
4
     50000     50059

方案一：更换应用端口（临时，最简单）#

不修改系统，直接让应用避开被预留的端口。

Spring Boot（application.yml）：

1
server:
2
  port: 8081

Spring Boot（application.properties）：

1
server.port=8081

优点：无需管理员权限，立即生效。
缺点：每次遇到新的被预留端口都要手动换。

方案二：排除指定端口不被预留（永久，推荐）#

以管理员身份运行 PowerShell，将特定端口从 Hyper-V 预留范围中永久排除：

1
# 排除 8080 端口
2
netsh int ipv4 add excludedportrange protocol=tcp startport=8080 numberofports=1

排除多个端口：

1
netsh int ipv4 add excludedportrange protocol=tcp startport=8080 numberofports=1
2
netsh int ipv4 add excludedportrange protocol=tcp startport=8443 numberofports=1

验证是否生效：

1
netsh interface ipv4 show excludedportrange protocol=tcp

优点：精准，只影响指定端口，重启后依然有效。
缺点：需要管理员权限，每个端口需单独添加。

方案三：重置动态端口范围（永久，根治）#

Hyper-V 默认从较低的端口号开始预留，调整动态端口起始范围可以让预留区域远离常用端口。

以管理员身份运行：

1
# 将动态端口范围调整为从 49152 开始（RFC 标准推荐范围）
2
netsh int ipv4 set dynamic tcp start=49152 num=16384
3
netsh int ipv6 set dynamic tcp start=49152 num=16384

然后重启 WinNAT 服务使其生效（无需重启电脑）：

1
Restart-Service winnat

或者重启电脑完全生效。

验证：

1
netsh interface ipv4 show excludedportrange protocol=tcp

优点：一次性解决，所有常用端口（8080、8443、3000 等）均不再被预留。
缺点：需要管理员权限，需重启服务或电脑。

方案四：禁用 WinNAT 服务（临时）#

如果不使用 WSL2 / Docker Desktop / Hyper-V 虚拟机，可以临时停止 WinNAT 服务释放预留端口：

1
# 停止服务（临时，重启后恢复）
2
net stop winnat
3

4
# 启动应用后，如需恢复
5
net start winnat

优点：立即释放所有预留端口。
缺点：会影响 WSL2、Docker Desktop、Hyper-V 虚拟机的网络功能；重启后自动恢复。

方案五：禁用 Hyper-V 自动预留（永久）#

彻底关闭 Hyper-V 的端口自动预留行为：

1
# 禁用自动预留
2
reg add HKLM\SYSTEM\CurrentControlSet\Services\hns\State /v EnableExcludedPortRange /d 0 /f

重启电脑后生效。

恢复：

1
reg add HKLM\SYSTEM\CurrentControlSet\Services\hns\State /v EnableExcludedPortRange /d 1 /f

优点：彻底解决预留问题。
缺点：可能影响 Hyper-V 相关功能的稳定性，不推荐在重度使用虚拟化的环境中使用。

方案对比#

常见受影响端口#

Hyper-V 预留的端口范围每次重启可能不同，以下端口经常受影响：

• 8080 — Spring Boot / Tomcat 默认端口
• 8443 — HTTPS 默认端口
• 3000 — Node.js / React 开发服务器
• 5000 — Flask / .NET 默认端口
• 8000 — Django 默认端口

参考#

• Microsoft Docs - netsh interface ipv4
• WSL2 Port Reservation Issue