Blazor PWA安装后无法运行，卡在加载状态求助

核心错误分析 #

Uncaught SyntaxError: Unexpected token '<' 是关键问题——这说明浏览器请求 blazor.webassembly.js 时，返回的不是JS文件而是HTML内容（通常是404错误页面），导致解析失败。以下是针对性排查步骤：

1. 务必先正确发布应用 #

VS调试模式运行的应用和发布版本的资源路径、缓存策略存在差异，直接从调试页面安装PWA会引发路径错误：

• 右键项目 → 发布，选择「文件夹」作为发布目标，完成全量发布流程。
• 发布后检查目录下的 wwwroot/_framework/blazor.webassembly.js 文件是否存在。

2. 验证资源引用路径 #

打开发布目录下的 wwwroot/index.html，确认Blazor核心脚本的引用路径正确：

<script src="_framework/blazor.webassembly.js"></script>

若路径存在拼写错误或多余前缀，浏览器会请求到错误地址，返回HTML页面触发语法错误。

3. 检查PWA配置文件 #

• 确认 wwwroot/manifest.json 中的 start_url 设置为 ./（相对路径），保证PWA启动时指向正确的入口页面。
• 检查 service-worker.js 和 service-worker-assets.js 是否存在于发布后的 wwwroot 目录，且 index.html 中的service worker注册脚本无误：

<script>
if ('serviceWorker' in navigator) {
    navigator.serviceWorker.register('service-worker.js')
        .then(() => console.log('Service worker registered'))
        .catch(err => console.error('Service worker registration failed:', err));
}
</script>

4. 清除旧缓存与已安装PWA #

• 在浏览器设置中找到已安装的该PWA应用，删除后重新尝试安装。
• 打开浏览器开发者工具（F12），在「Application」标签下清除所有缓存和service worker，再重新访问发布后的应用。

关于运行环境的疑问 #

• Kestrel：是ASP.NET Core的内置服务器，VS调试和命令行执行dotnet run时都会使用它。发布Blazor WASM应用后，可通过dotnet-serve工具（需全局安装：dotnet tool install --global dotnet-serve）托管发布目录，进入发布文件夹后运行dotnet serve即可快速测试。
• IIS：并非必需，Blazor WASM属于静态内容，可部署到任何支持静态文件的服务器（包括IIS、NGINX、GitHub Pages等）。若用IIS部署，需确保网站物理路径指向发布后的wwwroot目录，且IIS配置允许静态文件访问。
• 安装后的PWA运行依赖浏览器缓存机制，和本地服务器无关——只要发布包正确，安装后即使服务器关闭也能离线运行。

次要错误说明 #

DevTools failed to load source map 是bootstrap源码映射文件未找到的提示，属于非功能性错误，不影响应用运行，可忽略或添加对应的.map文件到发布目录。

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