Blazor WASM项目无法启动WASM调试 断点不命中问题求助

解决方案 #

• 优先清理所有调试相关缓存
  关闭所有IDE和调试启动的浏览器窗口，删除项目根目录下的.vs、bin、obj文件夹，同时清空以下路径的缓存：
  1. 浏览器所有localhost相关的缓存、Cookie、存储数据
  2. 系统临时目录下的Blazor调试代理缓存：C:\Users\<你的用户名>\AppData\Local\Temp\BlazorDebugProxy
• 排查服务 worker 缓存问题
  你项目中配置了Service Worker，开发环境下Service Worker会缓存静态资源和编译后的WASM dll、pdb符号文件，极易导致调试代理读取到旧的不匹配文件，出现断点无法绑定的问题。在index.html的Service Worker注册逻辑中增加开发环境判断，本地调试时不注册Service Worker即可：

  // 仅生产环境注册Service Worker
  if (!window.location.hostname.includes('localhost')) {
    navigator.serviceWorker.register('/service-worker.js');
  }
  

• 确认SDK和NuGet包版本匹配
  你项目使用的是.NET 5，Blazor相关NuGet包版本为5.0.7，运行dotnet --list-sdks命令确认本地安装的.NET 5 SDK版本和项目依赖版本兼容，建议将所有Blazor相关依赖升级到.NET 5的最终维护版本5.0.17，修复了多个调试相关的已知问题。
• 检查构建配置
  确认当前IDE使用的构建配置为Debug而非Release，右键项目→属性→构建，取消勾选「优化代码」，调试信息设置为「可移植」。
• 排查网络拦截问题
  调试启动前关闭所有本地代理工具（如Fiddler、Clash、Charles等），临时关闭系统防火墙，避免调试代理的WebSocket连接被拦截，出现无法连接调试目标的报错。
• VS额外调试配置
  打开VS→工具→选项→调试→常规：
  1. 取消勾选「启用仅我的代码」
  2. 勾选「启用源链接支持」
     切换到调试→符号页面，勾选「Microsoft符号服务器」，等待首次符号加载完成后再启动调试。

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