.NET 8.0 ASP.NET Core PWA报错：routes未定义求排查方案

云原生阿岚

2026-6-25

排查ASP.NET Core 8 PWA中service-worker的"routes is not defined"错误

以下是针对该错误的具体排查和解决方向：

显式配置PWA路由参数
你使用的WebEssentials.AspNetCore.PWA包在生成service-worker时，依赖传入的路由配置来定义routes变量。若未显式指定，会导致变量未定义。在AddProgressiveWebApp方法中补充路由配置：
```
builder.Services.AddProgressiveWebApp(options =>
{
    // 添加你需要缓存的路由列表
    options.Routes = new List<string> { "/", "/Home/Index", "/Home/About" };
});
```
检查包版本兼容性
确认你安装的WebEssentials.AspNetCore.PWA包版本是否适配.NET 8。部分旧版本可能未针对.NET 8的项目结构或API做适配，导致自动生成的service-worker代码存在问题。尝试升级到包的最新稳定版本，或查看包的官方文档确认兼容范围。
手动替换service-worker逻辑
若自动生成的service-worker代码存在问题，可以手动创建自定义的service-worker文件（放在wwwroot目录下），并替换有问题的缓存逻辑。例如将报错的代码段修改为直接指定缓存资源：
```
function updateStaticCache() {
  return caches.open(version).then(function (cache) {
    // 直接列出需要缓存的资源和路由
    return cache.addAll([offlineUrl, "/", "/Home/Index"]);
  });
}
```
同时在Program.cs中指定使用自定义的service-worker：
```
builder.Services.AddProgressiveWebApp(options =>
{
    options.ServiceWorkerScriptFile = "/service-worker.js";
});
```
验证中间件配置完整性
确保在Program.cs中添加了PWA中间件：
```
app.UseProgressiveWebApp();
```
虽然你的应用已显示安装选项，但中间件的配置细节可能影响service-worker的代码生成，确认该中间件在app.UseStaticFiles()之后添加。
查看包的社区反馈
该包的代码仓库或NuGet页面可能有其他.NET 8用户遇到相同问题的解决方案，检查是否有已提交的issue或修复方案，了解官方是否有修复计划或临时处理办法。