VS Code调试Blazor WASM客户端报错：URL协议需为ws/wss/ws+inix

核心原因 #

这个问题大概率是调试配置文件错误或者SDK版本不匹配导致的——结合你提到VS2022能正常运行，重点排查VS Code的配置和SDK适配问题即可。

具体解决步骤 #

• 恢复默认调试配置
  删掉项目根目录下的.vscode文件夹，重新打开项目让VS Code自动生成launch.json和tasks.json，不要做任何修改直接按F5调试。很多时候手动修改配置会误改调试协议相关参数，导致出现ws/wss协议错误。

• 匹配SDK与项目版本
  你的项目是6.0版本的Blazor WASM，但当前用的是.NET 7 SDK，版本不兼容可能引发调试问题：

  1. 打开项目的.csproj文件，确认<TargetFramework>值为net6.0；
  2. 在项目根目录创建global.json文件，强制指定使用6.0的SDK：

     {
       "sdk": {
         "version": "6.0.405"
       }
     }
     

  3. 终端运行dotnet restore重新恢复依赖。

• 检查launch.json关键配置
  确保launch.json里的核心参数正确，不要混淆应用访问协议和调试通道协议：

  {
    "name": "Launch and Debug Standalone Blazor WebAssembly App",
    "type": "blazorwasm",
    "request": "launch",
    "cwd": "${workspaceFolder}",
    "url": "http://localhost:5000" // 这里是http/https，不是ws/wss
  }
  

  注意url必须是应用的访问地址，不能写成ws://开头的调试协议。

• 清理缓存与重建项目

  1. 删除项目的bin和obj文件夹；
  2. 终端执行dotnet clean && dotnet build；
  3. 用浏览器无痕模式启动调试，避免旧缓存干扰。

• 解决Edge崩溃问题

  1. 更新VS Code的C#扩展和Edge浏览器到最新版本；
  2. 关闭Edge所有插件后再尝试调试，排除插件冲突；
  3. 如果还是崩溃，切换回Chrome调试，确认是浏览器本身的问题还是配置问题。

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