VS Code调试ASP.NET Core时ASPNETCORE_HTTP_PORTS被覆盖问题

5001端口的来源 #

这个5001端口大概率来自VS Code的调试配置文件.vscode/launch.json，常见两种场景：

• launch.json明确指定了端口参数：如果你的.vscode/launch.json里配置了"applicationUrl": "https://localhost:5001"，或者在args数组中添加了"--urls=https://localhost:5001"，由于命令行参数的优先级高于launchsettings.json中的环境变量配置，会直接覆盖ASPNETCORE_HTTP_PORTS的设置。
• 未指定端口时的框架默认 fallback：当VS Code调试会话未通过配置明确指定端口时，ASP.NET Core会启用框架默认的HTTPS端口5001（对应HTTP默认端口5000），此时框架会优先使用默认URL配置，忽略launchsettings.json中的ASPNETCORE_HTTP_PORTS。

VS Code是否会向调试会话注入环境变量 #

是的，VS Code的调试系统会通过.vscode/launch.json中的env字段向调试会话注入环境变量，且这些变量的优先级高于launchsettings.json中定义的环境变量。此外，launch.json中指定的命令行参数（args字段）优先级最高，会直接覆盖任何通过环境变量设置的端口配置。

快速解决建议 #

1. 打开项目根目录下的.vscode/launch.json文件，检查以下配置：
   • 若存在applicationUrl，将其修改为http://localhost:5003
   • 若args数组中有--urls参数，替换为"--urls=http://localhost:5003"
   • 若env字段中存在ASPNETCORE_URLS，删除该配置或修改为对应端口
2. 确保launch.json中的env字段没有覆盖ASPNETCORE_HTTP_PORTS的值

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