.NET 8 Blazor Server托管Wasm应用热重载失效问题求助

问题描述 #

我有一个基于.NET 8的Blazor Server托管WebAssembly客户端应用，该应用从.NET 5起便存在且历经多次更新。某一时刻热重载（Hot Reload）停止工作，热重载运行正常，浏览器网络面板也显示了相应消息，浏览器中也能看到典型的钩子，但网站并未更新。

已尝试的排查步骤 #

• 检查启动设置
• 检查输出窗口
• 检查网络面板
• 咨询ChatGPT
• 搜索谷歌
• 在此提问

可能的原因及解决办法 #

• 缓存问题：浏览器或项目缓存可能阻碍更新生效，可尝试：
  • 强制刷新浏览器（Ctrl+Shift+R 或 Cmd+Shift+R）
  • 删除项目的bin和obj目录，重新生成解决方案
• 钩子冲突：自定义JS代码或第三方库可能与热重载钩子冲突。排查项目中修改DOM、拦截网络请求的自定义脚本，临时禁用后测试热重载是否恢复。
• 版本升级残留：从.NET 5多次升级到.NET 8，可能存在配置或依赖冲突：
  • 检查launchSettings.json，确认hotReloadProfile等热重载配置是否适配.NET 8
  • 更新所有NuGet包至.NET 8兼容的最新版本，清除旧包缓存
• 组件状态干扰：部分组件的状态管理逻辑可能阻止重新渲染。检查组件是否使用[PreserveState]特性，或在OnInitializedAsync等生命周期方法中有数据缓存逻辑，临时注释后测试。
• 调试进程问题：调试器未正确附加到客户端进程会导致更新无法同步。确保调试器同时附加到Server和WASM客户端进程，在Visual Studio中可通过「调试」->「附加到进程」选择对应进程。

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