You need to enable JavaScript to run this app. VS2019升级.NET 5后Blazor Server端Hot Reload失效如何配置启用
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.14 17:15:06