通过hosts指向localhost的URL访问时IDE调试Blazor WASM断点不命中

该场景完全支持调试Blazor WASM应用，断点不命中是默认调试配置的主机名校验规则导致的，不属于功能限制。

Blazor WASM的调试流程依赖内置的DevTools调试代理，这个代理默认仅允许来源为localhost的调试连接，属于默认的安全防护规则。即使你通过hosts文件把自定义域名解析到了127.0.0.1，调试代理识别到请求的Host头不是localhost时，会直接拒绝调试连接，IDE自然无法加载断点、也不会收到调试符号命中的通知。

• 配置应用绑定自定义域名
  打开项目下的Properties/launchSettings.json，找到你当前使用的启动配置项（一般是对应Kestrel的项目名配置，或者IIS Express配置），在applicationUrl字段里追加你配置的自定义域名地址，比如原来的值是http://localhost:5000;https://localhost:5001，就改成http://localhost:5000;https://localhost:5001;http://myapp.local:5000;https://myapp.local:5001，这里的myapp.local替换成你在hosts里配置的自定义域名。
• 给调试代理放行自定义域名
  打开Rider的Run > Edit Configurations面板，找到你当前用的Blazor启动配置，在Environment variables配置项里新增一条环境变量：

  BlazorDevToolsAllowHosts=myapp.local
  

  如果有多个自定义域名需要放行，用分号分隔即可。
• 处理开发证书信任问题
  第一次用自定义域名访问HTTPS地址时，浏览器会提示开发证书不受信任，手动选择信任该本地开发证书，否则浏览器会拦截调试代理的WebSocket连接，同样会导致断点失效。
• 全量重启调试会话
  关闭之前所有正在运行的应用进程、退出残留的调试代理进程，重新在Rider里启动调试。不要使用热加载应用配置修改，必须启动全新的调试会话，启动后直接用自定义域名访问应用即可正常命中断点。

如果配置后还是无法命中断点，可以先把环境变量ASPNETCORE_DETAILEDERRORS设为true，重启调试后看Rider的调试输出窗口，会打印调试代理的连接日志，根据日志提示排查是主机名拦截、证书拦截还是端口占用问题即可。

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