Blazor WASM Hosted启用HotReload保存Razor文件触发异常求助

• 清理依赖与排查冲突

  • 执行dotnet nuget locals all --clear清除NuGet缓存，再运行dotnet restore重新还原依赖，避免缓存中损坏的包引发问题
  • 暂时移除项目中的第三方组件或自定义扩展包，逐个重新引入并测试，排查是否是某个包与官方HotReload逻辑冲突

• 核对项目配置细节

  • 对比正常项目的.csproj文件，检查EnableHotReload、HotReloadProfile等相关配置项是否一致，避免异常配置干扰HotReload流程
  • 查看launchSettings.json中的调试参数，确认没有添加可能影响HotReload的额外参数

• 清除构建与浏览器缓存

  • 删除项目根目录下的bin和obj文件夹，执行dotnet clean彻底清理构建输出
  • 打开浏览器开发者工具，在Application标签下清除站点数据，避免Blazor WASM的旧缓存导致更新异常

• 排查代码中的潜在问题

  • 检查Razor组件和全局逻辑中是否存在未初始化的对象调用，尤其是在生命周期方法（如OnInitializedAsync）或动态组件生成逻辑中，这类代码在HotReload更新时容易触发空引用
  • 确认是否使用了自定义的[HotReload]特性或相关扩展，错误的特性使用可能破坏官方HotReload的执行流程

• 捕获更详细的异常信息

  • 在Visual Studio中启用项目的“启用本机代码调试”选项，尝试在异常触发时捕获更精准的调用栈和空引用对象
  • 使用dotnet watch run命令启动项目，观察控制台输出的HotReload日志，获取更多错误细节

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