Blazor WASM部署至Azure静态Web App时wwwroot子文件夹缺失求助

AI 小北

2026-6-15

解决.NET 9 Blazor WASM部署Azure静态Web App时wwwroot子文件夹未同步问题

针对你遇到的wwwroot下resources文件夹及xml文件无法部署到Azure静态Web App的问题，可按以下步骤排查解决：

手动配置项目文件（.csproj）
打开项目的.csproj文件，添加明确的ItemGroup配置，确保文件夹及文件被纳入发布范围：
```
<ItemGroup>
  <Content Include="wwwroot\resources\**\*">
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
</ItemGroup>
```
注：Blazor WASM发布时，CopyToPublishDirectory是控制文件是否被打包到发布包的关键配置，仅设置CopyToOutputDirectory可能不生效。
检查Azure静态Web App配置文件
查看项目根目录的azure.staticwebapp.config.json，确认没有将resources文件夹加入排除规则。如果存在类似以下内容，删除对应的exclude条目：
```
{
  "exclude": [
    "wwwroot/resources/**"
  ]
}
```
清理本地缓存并重新发布
1. 右键项目，选择「清理」，清除本地生成缓存
2. 右键项目，选择「生成」，重新编译项目
3. 执行发布操作，确保使用最新的生成文件
验证GitHub Actions工作流（若使用CI/CD部署）
检查.github/workflows下的Azure静态Web App部署工作流文件，确认build命令正确，且未添加忽略wwwroot/resources的步骤。.NET 9的标准发布命令应为：
```
dotnet publish -c Release -o bin/Release/net9.0/publish
```
排查PWA配置（若启用PWA）
若项目启用了PWA，检查service-worker.published.js中的缓存配置，确保resources文件夹及xml文件被包含在precache清单中，避免因缓存策略导致文件看似未部署（实际已部署但未被缓存）。