.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
相关产品推荐
相关产品推荐

