首次加载时随机.wasm文件请求失败的原因排查

问题现象 #

• 清除浏览器缓存后或使用无痕模式加载Blazor站点，会随机出现.wasm文件（如System.Threading.wasm）下载失败，站点卡在加载界面；刷新页面后可正常访问。
• Chrome控制台会抛出net::ERR_FAILED错误，同时伴随初始化器被忽略的警告；Firefox无此问题，多设备、多Blazor站点测试均仅Chrome出现该情况。

可能原因 #

• Chrome在无痕/无缓存场景下的并行资源加载策略，与Blazor的.wasm资源加载机制存在兼容性冲突，导致部分请求被意外中断。
• 无缓存状态下，Chrome对Blazor资源的请求优先级或时序处理异常，引发初始化流程报错。

解决方案 #

1. 调整Blazor初始化时机 #

修改项目入口文件（WebAssembly项目为index.html，Server项目为_Host.cshtml），关闭Blazor脚本的自动启动，改为页面加载完成后手动启动，确保资源加载时序稳定：

<script src="_framework/blazor.webassembly.js" autostart="false"></script>
<script>
  window.addEventListener('load', () => {
    Blazor.start();
  });
</script>

2. 配置.wasm文件的缓存策略 #

在ASP.NET Core服务器端为.wasm文件设置强缓存头，减少无缓存场景下的重复请求压力。在Program.cs中添加静态文件缓存配置：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        if (ctx.File.Name.EndsWith(".wasm"))
        {
            ctx.Context.Response.Headers.Append("Cache-Control", "public, max-age=31536000, immutable");
        }
    }
});

3. 临时禁用Chrome并行下载（测试用） #

在Chrome地址栏输入chrome://flags/#enable-parallel-downloading，将该选项设置为Disabled，测试是否解决问题。若有效，说明并行加载是导致请求失败的直接原因。

4. 升级依赖版本 #

确保使用的Blazor SDK为最新稳定版，同时将Chrome浏览器升级到最新版本，这类兼容性问题通常会在官方后续更新中得到修复。

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