You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

.NET5升级至.NET6后Blazor WASM项目Hot Reload功能失效如何解决?

Blazor WASM 从.NET 5升级至.NET 6后Hot Reload失效修复步骤

按照以下顺序排查配置即可解决问题:

  • 修正项目文件配置
    打开你的Blazor WASM项目的.csproj文件,在顶层<PropertyGroup>节点中添加如下配置:
<HotReloadEnabled>true</HotReloadEnabled>
<HotReloadProfile>blazorwasm</HotReloadProfile>

同时确认所有Microsoft.AspNetCore.Components.WebAssembly开头的NuGet包版本均为6.0.x正式版,无版本混用情况。

  • 更新launchSettings.json配置
    打开项目Properties目录下的launchSettings.json,找到你正在使用的启动配置项,确保包含如下配置:
"hotReloadProfile": "blazorwasm",
"environmentVariables": {
  "ASPNETCORE_ENVIRONMENT": "Development"
}

热重载默认仅在开发环境生效,若环境变量配置为Production会直接禁用该功能。

  • 清理残留缓存
    关闭Visual Studio,手动删除项目根目录下的bin、obj文件夹,同时清理浏览器缓存或使用隐私模式启动测试,重启Visual Studio后重新构建运行项目。旧版本的构建缓存残留是升级场景下热重载失效的高频原因。
  • 校验Program.cs入口配置
    确认.NET6的Program.cs入口中没有显式禁用热重载的代码,不要出现类似builder.WebHost.UseHotReload(false)的配置项,使用默认的WebAssemblyHostBuilder.CreateDefault(args)初始化即可。

补充注意:如果项目开启了强制HTTPS配置,请确保浏览器访问的是HTTPS协议的站点地址,HTTP地址下热重载依赖的WebSocket连接会被拦截,导致信号无法传递到前端页面。

内容的提问来源于stack exchange,提问作者Kevon

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 09:36:03