Blazor WebAssembly构建变更不生效问题求助（.NET 9.0.2）

问题现象 #

• 热重载完全失效，必须频繁重启解决方案
• 构建操作显示成功，但代码修改未被包含，需连续重启两次才生效
• 首次重启后控制台弹出完整性属性缺失及部分404错误，二次重启后错误消失、修改生效
• 手动构建修改过的Blazor项目后，首次重启即可使变更生效

排查修复步骤 #

1. 检查项目热重载配置 #

打开项目的.csproj文件，确认是否包含以下配置，没有则手动添加：

<PropertyGroup>
  <HotReloadProfile>blazorwasm</HotReloadProfile>
  <EnableHotReload>true</EnableHotReload>
</PropertyGroup>

保存后重启IDE。

2. 彻底清理构建缓存 #

• 删除项目根目录下的bin和obj文件夹
• 清除浏览器缓存（按Ctrl+Shift+Delete，勾选缓存文件选项）
• 执行命令行清理：

dotnet clean
dotnet restore

3. 调整IDE构建行为 #

在Visual Studio中：

• 进入工具>选项>项目和解决方案>生成并运行
• 勾选在运行前生成
• 将当项目过期时设置为始终生成
• 关闭快速启动功能，避免跳过必要构建步骤

4. 临时禁用调试模式下的完整性校验 #

Blazor WASM的完整性校验会拦截未签名的修改文件，可在Program.cs中添加调试模式下的禁用代码：

#if DEBUG
builder.Services.AddBlazorWebAssemblyDeveloperTools();
// 禁用完整性校验，仅调试模式使用
builder.WebAssemblyHostOptions.DisableImplicitAssetBundleDigests = true;
#endif

注意：发布版本必须移除该设置，保障生产环境安全。

5. 更新.NET SDK及IDE #

确保.NET 9.0.2是最新补丁版本，同时将Visual Studio更新到2022 17.10及以上版本，部分热重载问题已在后续补丁中修复。

6. 核对启动项目配置 #

• 确认启动项目为Blazor WASM项目（托管模式下不要误选服务器项目）
• 托管模式下，检查服务器项目的launchSettings.json，确保hotReloadEnabled设为true：

"profiles": {
  "https": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "applicationUrl": "https://localhost:5001;http://localhost:5000",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    },
    "hotReloadEnabled": true
  }
}

7. 排查第三方扩展干扰 #

临时禁用Visual Studio中的第三方扩展（如Resharper、CodeRush等），部分扩展会干扰热重载和构建流程。

内容的提问来源于stack exchange，提问作者gtu