Blazor WASM发布后启动报错Failed to start platform该如何排查？

Error: Failed to start platform. Reason: TypeError: NetworkError when attempting to fetch resource 本质是Blazor WASM启动过程中请求运行时依赖的资源时出现网络异常，可按以下方向逐步排查：

1. 定位具体加载失败的资源 #

• 打开浏览器开发者工具的「网络」面板，刷新页面后筛选状态码为4xx、5xx的请求，确认是_framework目录下的哪类资源加载失败，常见异常资源包括dotnet.wasm运行时文件、业务dll程序集、blazor.boot.json配置文件、资源清单文件等
• 核对资源请求路径是否符合预期：如果站点部署在子路径下，需要修改wwwroot/index.html中的<base href="..." />配置与部署路径匹配，比如部署在https://domain.com/blazor-app/路径时，base值需改为/blazor-app/，默认的/仅适用于根域名部署场景

2. 检查Web服务器MIME类型配置 #

Blazor WASM要求服务器支持以下后缀的MIME类型，配置缺失会导致资源被拦截返回404：

• .wasm 对应MIME类型为 application/wasm
• .dll 对应MIME类型为 application/octet-stream
• .json 对应MIME类型为 application/json
• 若开启了发布压缩，还需支持.br（brotli压缩）、.gz（gzip压缩）后缀的资源响应，同时正确配置压缩内容的响应头

3. 校验发布产物完整性 #

• 对比本地发布生成的wwwroot/_framework目录与服务器上部署的对应目录，确认文件没有缺失、上传不完整的问题
• 检查服务器上静态资源的访问权限，确认_framework目录下的文件允许匿名访问
• 若使用CI/CD自动部署，检查打包规则是否没有过滤dll、wasm类后缀的文件

4. 排查访问拦截规则 #

• 检查WAF、CDN的安全策略，确认没有拦截.dll、.wasm类后缀的资源请求，多数默认安全规则会禁止这类可执行格式资源的访问
• 若站点配置了身份验证规则，需要放开_framework路径下所有静态资源的访问权限，避免被登录校验拦截
• 若应用存在跨域接口调用，确认后端CORS配置正确，接口没有返回跨域错误

5. 开启详细加载日志 #

在index.html中修改blazor运行时的引入配置，添加资源加载日志输出，快速定位异常资源：

<!-- 禁用自动启动 -->
<script src="_framework/blazor.webassembly.js" autostart="false"></script>
<script>
Blazor.start({
  // 自定义资源加载逻辑，输出每个资源的加载信息
  loadBootResource: function (type, name, defaultUri, integrity) {
    console.log(`加载资源类型[${type}]，名称[${name}]，请求地址[${defaultUri}]`);
    return fetch(defaultUri, { cache: 'no-cache' });
  }
});
</script>

配置后刷新页面，控制台会输出所有启动资源的加载明细，可直接定位到请求失败的资源。

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