升级Win11后，如何阻止VS调试时IIS Express+SpaServices端口随机变更？

问题原因 #

• Windows 11端口管理机制调整：系统默认动态端口范围（49152-65535）的检测逻辑变化，SpaServices绑定3000端口时，可能被系统判定为“不可用”，自动 fallback 到随机动态端口。
• Visual Studio与Windows 11兼容性异常：IIS Express和SpaServices的端口同步逻辑出现偏差，虽然launchsettings.json配置了3000且IIS Express显示正常，但SpaServices未正确读取配置，被系统端口策略覆盖。
• React Dev Server误判端口占用：Windows 11的端口检测机制和Windows 10不同，导致React Dev Server误判3000端口已被占用，自动切换到随机端口。

解决方法 #

1. 强制锁定React Dev Server端口 #

后端配置（ASP.NET Core）

在Program.cs（.NET 6+）或Startup.cs中，明确指定React Dev Server的端口：

// Program.cs 示例
var builder = WebApplication.CreateBuilder(args);
// ... 其他配置 ...

var app = builder.Build();
// ... 中间件配置 ...

app.UseSpa(spa =>
{
    spa.Options.SourcePath = "ClientApp";
    if (app.Environment.IsDevelopment())
    {
        spa.UseReactDevelopmentServer(npmScript: "start", options =>
        {
            options.Port = 3000;
        });
    }
});

app.Run();

React前端配置

修改项目根目录下的package.json，在start脚本中强制指定端口：

"scripts": {
  "start": "react-scripts start --port 3000",
  "build": "react-scripts build",
  "test": "react-scripts test",
  "eject": "react-scripts eject"
}

2. 调整Windows 11动态端口范围 #

以管理员身份打开命令提示符，执行以下命令将动态端口范围调整到50000以上，避免和3000端口冲突：

netsh int ipv4 set dynamicport tcp start=50000 num=15535
netsh int ipv4 set dynamicport udp start=50000 num=15535

执行后重启电脑生效。

3. 重置IIS Express配置 #

删除用户目录下的IIS Express配置文件，路径为：C:\Users\[你的用户名]\Documents\IISExpress\config，删除该目录下所有文件后，重新打开Visual Studio并生成解决方案，让系统重新生成配置。

4. 配置防火墙允许3000端口 #

1. 打开「Windows Defender防火墙」→「高级设置」
2. 添加入站规则：允许TCP协议的3000端口
3. 添加出站规则：允许TCP协议的3000端口

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