.NET 8.0升级后WinForms中Blazor Hybrid ClickOnce发布wwwroot路径异常

1. 同类问题情况 #

不少开发者在将WinForms托管的Blazor Hybrid应用升级到.NET 8后，遇到了ClickOnce发布版本静态资源路径异常的问题，和你描述的症状完全一致——发布后应用试图读取开发机器的wwwroot路径，而非部署后的本地路径。

2. .NET 8相关已知变更 #

.NET 8对Blazor Hybrid的静态资源处理和ClickOnce打包逻辑做了以下关键变更，可能导致该问题：

• 调整了StaticWebAssetBasePath的默认行为，开发环境下自动绑定项目输出目录，但发布阶段未正确切换到ClickOnce的部署路径
• ClickOnce打包规则更新，旧版.NET中自动包含的wwwroot资源，在.NET 8中需要显式配置才能确保被打包进发布包
• BlazorWebView的初始化逻辑优化了资源加载优先级，但未适配ClickOnce这种特殊的部署目录结构

3. 解决方案与排查步骤 #

先做排查验证 #

• 确认发布包内容：找到用户机器上ClickOnce的部署目录（通常在%USERPROFILE%\AppData\Local\Apps\2.0下的随机命名文件夹），检查wwwroot文件夹及内部的CSS、JS等资源是否存在
• 输出运行时路径：在WinForms窗体的BlazorWebView初始化代码中添加日志，打印AppContext.BaseDirectory和当前加载的静态资源路径，确认是否错误指向开发环境路径

具体修复方案 #

方案1：显式配置项目静态资源打包规则

在项目的.csproj文件中添加以下配置，强制指定静态资源的发布行为：

<PropertyGroup>
  <!-- 明确静态资源基础路径 -->
  <StaticWebAssetBasePath>wwwroot</StaticWebAssetBasePath>
</PropertyGroup>
<ItemGroup>
  <!-- 确保wwwroot所有资源被复制到发布目录并包含进ClickOnce -->
  <Content Update="wwwroot\**">
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    <IncludeInClickOnce>true</IncludeInClickOnce>
  </Content>
</ItemGroup>

方案2：修改BlazorWebView初始化逻辑，指定正确路径

在WinForms窗体中初始化BlazorWebView时，显式设置宿主页面和静态资源的根路径为应用的实际部署目录：

var blazorWebView = new BlazorWebView();

// 获取ClickOnce部署后的应用根目录
string appRoot = ApplicationDeployment.IsNetworkDeployed 
    ? ApplicationDeployment.CurrentDeployment.DataDirectory 
    : AppContext.BaseDirectory;

// 绑定正确的宿主页面路径
blazorWebView.HostPage = Path.Combine(appRoot, "wwwroot/index.html");

// 保持原有服务配置
blazorWebView.Services = serviceProvider;
blazorWebView.RootComponents.Add<App>("#app");

// 将BlazorWebView添加到窗体控件集合
this.Controls.Add(blazorWebView);
blazorWebView.Dock = DockStyle.Fill;

方案3：清理缓存后重新发布

• 清理项目本地缓存：删除项目根目录下的obj和bin文件夹，重新生成解决方案后再执行ClickOnce发布
• 指导用户清理本地ClickOnce缓存：打开控制面板的「程序和功能」，找到目标应用右键选择「卸载/更改」，然后选择「清除在线应用程序缓存」

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