VS2019升级.NET 5后Blazor Server端Hot Reload失效如何配置启用
.NET 5 下Blazor Server 启用Hot Reload的配置与排查清单
版本前置校验
- Visual Studio 2019 需升级至 16.8及以上正式版本,预览版需达到16.9 Preview 1及以上,低版本VS即便安装了.NET 5 SDK也不会加载Hot Reload核心模块
- 确认环境内安装的是正式发布版.NET 5 SDK,且VS已正确关联对应SDK路径,未错误关联到3.x时代的旧SDK版本
项目级基础配置
- 检查项目.csproj文件的SDK引用,必须使用
<Project Sdk="Microsoft.NET.Sdk.Web">,不能混用Blazor 3.x 时代遗留的Microsoft.AspNetCore.Blazor.Server旧SDK - 打开项目路径下
Properties/launchSettings.json,在当前使用的启动配置(Kestrel自宿主、IIS Express等)中新增配置项:"hotReloadProfile": "aspnetcore" - 确保.csproj文件中未手动设置
<RazorCompileOnBuild>false</RazorCompileOnBuild>,该配置会直接阻断运行时动态编译触发流程 - 检查Program.cs启动逻辑,需遵循.NET 5通用主机标准启动方式,避免自定义管线拦截Blazor Server的热更新websocket通道——Blazor的Hot Reload依赖默认管线的Razor动态编译、组件更新推送能力,自定义主机配置存在拦截更新信号的风险
VS调试侧开关设置
- 启动调试前,打开顶部调试按钮旁的下拉菜单进入项目调试属性,找到Hot Reload配置页,勾选“启动时启用Hot Reload”,同时开启“应用代码更改后自动刷新浏览器”选项
- 必须使用带调试器附加的F5方式启动项目,.NET 5版本的Hot Reload不支持无调试的Ctrl+F5启动场景,该模式下不会加载热更新模块
- 避免以附加外部进程调试的方式使用Hot Reload,.NET 5阶段该场景下热更新能力未做兼容
高频失效场景排查
- 核对项目NuGet包版本,避免错装与SDK版本不匹配的
Microsoft.AspNetCore.Components系列包,版本错位会直接导致热更新逻辑失效 - 检查浏览器控制台的Blazor websocket连接状态,如果存在请求被拦截报错,需排查第三方广告拦截插件、本地网络代理对
/_blazor路径请求的拦截 - 注意.NET 5版本的能力边界:该阶段Hot Reload仅支持razor视图、C#组件代码的热更新,不支持wwwroot目录下静态css、js资源的自动刷新,改静态资源需手动刷新页面才能生效
内容的提问来源于stack exchange,提问作者Craig
相关产品推荐
相关产品推荐

