如何调试Blazor Server仅控制台报i.parentNode is null的Circuit异常

这个报错本质是Blazor服务端维护的渲染树和浏览器实际DOM树状态不一致，前端渲染脚本尝试操作已经被移除的DOM节点触发的异常，可按以下优先级排查：

1. 优先验证全局静态资源与JS逻辑（匹配你空页面也报错的特征） #

• 检查_Layout.cshtml/App.razor等全局入口文件中引入的所有第三方JS脚本、自定义JS代码，有没有全局修改/删除DOM节点的逻辑，Blazor不知道前端手动修改了DOM，后续渲染操作就会触发节点找不到的错误。
• 确认项目引用的_framework/blazor.server.js和你当前使用的.NET SDK版本完全匹配，不要使用CDN引用的非对应版本，也不要手动替换该文件，版本不匹配会直接导致前后端渲染逻辑不一致。清理浏览器缓存后重试，排除旧版本脚本缓存的影响。

2. 排查渲染语法错误 #

• 检查所有Razor组件（包括全局的MainLayout.razor、导航组件等全局布局类组件）有没有以下不规范写法：
  • HTML标签未闭合，或者动态生成HTML时出现标签嵌套/匹配错误
  • 循环渲染列表类元素时未添加@key属性，导致Blazor的DOM Diff算法识别节点错误
• 可以先注释掉所有布局中的自定义内容，只保留纯文本输出，确认错误消失后再逐个恢复内容定位问题点。

3. 开启前端调试日志获取更多线索 #

修改blazor.server.js的引入配置，打开Debug级别的前端日志，定位报错前最后操作的组件：

<!-- 把原来的blazor.server.js引入替换成以下内容 -->
<script src="_framework/blazor.server.js" autostart="false"></script>
<script>
Blazor.start({
    logLevel: "Debug"
});
</script>

开启后浏览器控制台会输出完整的渲染操作日志，可以定位到错误触发前最后更新的组件范围，缩小排查目标。

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