.NET 6 Preview 5启用热重载的Blazor Assembly项目无法运行求助

算力阿峰

2026-10-12

Blazor WASM .NET 6 热重载加载失败解决方案

该报错核心原因为运行时无法加载热重载所需的blazor-hotreload.js资源，大多由预览版版本不匹配、配置项缺失导致，可按以下步骤排查修改：

修正SDK版本不匹配问题
你当前安装的是.NET 6 Preview 3，但报错日志显示依赖的是Preview 5版本的JS运行时，版本错位会导致内置热重载资源缺失。请先卸载本地所有.NET 6预览版SDK，安装统一的**.NET 6 正式版**（预览版本身热重载功能存在大量未修复缺陷，不建议继续使用），安装完成后执行dotnet --version确认版本号为6.0.100及以上。
修正项目文件配置
打开你的.csproj项目文件，确保以下配置正确：

<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <BlazorWebAssemblyLoadAllGlobalizationData>true</BlazorWebAssemblyLoadAllGlobalizationData>
    <!-- 开启热重载全局支持 -->
    <HotReloadEnabled>true</HotReloadEnabled>
  </PropertyGroup>
</Project>

修正launchSettings.json配置
除了已添加的"hotReloadProfile": "blazorwasm"，还要补充调试代理配置inspectUri，同时确保applicationUrl配置的端口和你访问的端口一致，示例配置如下：

"profiles": {
  "https": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
    "applicationUrl": "https://localhost:5555;http://localhost:5000",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    },
    "hotReloadProfile": "blazorwasm"
  }
}