.NET Aspire项目中VS Code端口转发功能失效求助

以下是针对该问题的实用排查和解决步骤：

• 确认转发目标是Aspire Proxy端口
  Aspire项目的入口是Proxy服务，而非单个业务服务（比如Blazor Server）。默认Aspire Starter模板中，Proxy通常监听5000（HTTP）或5001（HTTPS）端口，你需要转发的是Proxy的监听端口，不是Blazor服务的独立端口。

• 匹配Dev Tunnel与Proxy的协议
  如果Proxy配置了HTTPS（launchSettings.json中applicationUrl包含https://localhost:5001），则Dev Tunnel必须选择HTTPS模式；反之如果用HTTP，Dev Tunnel也要对应HTTP模式。协议不匹配会直接返回400错误。

• 检查Proxy的launchSettings配置
  打开Aspire Proxy项目的launchSettings.json，确认applicationUrl配置的端口未被占用：

  "applicationUrl": "http://localhost:5000;https://localhost:5001"
  

  可通过系统命令检查端口占用：

  • Windows：netstat -ano | findstr :5000
  • Mac/Linux：lsof -i :5000

• 验证VS Code端口转发的配置细节
  在VS Code的端口面板中，转发Proxy端口时：

  • 确保勾选的是Proxy对应的本地端口
  • 确认转发的端口类型（HTTP/HTTPS）与Proxy一致
  • 尝试直接访问Dev Tunnel的根路径，避免添加额外的路径前缀（部分场景下Dev Tunnel会自动添加前缀导致路由不匹配）

• 检查Aspire AppHost的服务注册
  打开AppHost项目，确认业务服务（比如Blazor Server）已被正确注册并关联到Proxy：

  var blazorService = builder.AddProject<Projects.MyBlazorApp>("blazorapp");
  builder.AddAspireProxy("proxy")
         .WithReference(blazorService);
  

  若服务未被Proxy正确引用，请求无法转发会返回400。

• 清除缓存并重启环境
  关闭VS Code，杀掉所有.NET相关进程（如dotnet.exe），重新打开项目并启动Aspire解决方案，再尝试创建Dev Tunnel转发。

• 先验证本地Proxy访问
  先在本地直接访问Proxy的端口（如http://localhost:5000），确认能正常加载页面。如果本地访问都失败，问题根源在Aspire项目配置而非Dev Tunnel。

内容的提问来源于stack exchange，提问作者Carl Heinrich Hancke