.NET 8 Blazor WASM Azure部署版本不匹配及资源完整性错误求助

1. 确认Azure App Service的运行环境版本 #

• 登录Azure门户，进入目标App Service，点击配置 -> 常规设置
• 检查“.NET版本”设置为**.NET 8**，若需指定具体补丁版本，在“应用程序设置”中添加WEBSITE_DOTNET_VERSION，值设为8.0.201（与你的global.json中SDK版本对应）
• 进入Kudu高级工具（App Service概览页点击“高级工具”->“Go”），打开控制台执行 dotnet --version，确认环境SDK版本为8.0.201

2. 统一项目配置中的框架版本 #

• 打开所有项目（Client/Server/Shared）的.csproj文件，确认：
  • <TargetFramework>值为net8.0
  • 添加或保留<RuntimeFrameworkVersion>8.0.2</RuntimeFrameworkVersion>（强制使用指定runtime版本，避免自动拉取其他补丁版）
  • 所有.NET 8相关NuGet包（如Microsoft.AspNetCore.Components.WebAssembly）版本统一为8.0.2，无残留旧版本或8.0.7版本的包

3. 彻底清理并重新发布 #

• 本地执行以下命令清理项目：

  dotnet clean
  dotnet restore --force
  dotnet build -c Release
  

• 发布时使用干净的输出目录，避免与旧发布文件混合：

  dotnet publish -c Release -o ./publish /p:SkipInvalidConfigurations=true
  

• 通过Kudu工具手动清空Azure部署目录：进入Kudu的“Debug console”->“PowerShell”，执行 Remove-Item -Path D:\home\site\wwwroot\* -Recurse -Force，再重新部署新发布包

4. 处理浏览器缓存与完整性校验错误 #

• 版本不匹配会导致dotnet.native.wasm的哈希值与index.html中integrity属性不一致，解决版本问题后重新发布即可生成正确哈希
• 若浏览器仍缓存旧资源，在App Service的“应用程序设置”中添加ASPNETCORE_CACHE_BUSTING_VERSION，值设为唯一字符串（如20240520），强制浏览器刷新静态资源

5. 验证global.json生效 #

• 在解决方案根目录本地执行 dotnet --version，确认输出为8.0.201，确保IDE或发布工具使用指定版本的SDK

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