You need to enable JavaScript to run this app. Next.js使用next-pwa开发PWA时Chrome报Failed to fetch错误求助
优惠活动
大模型
产品
解决方案
定价
更多

Next.js使用next-pwa开发PWA时Chrome报Failed to fetch错误求助

Next.js 接入 next-pwa 后 Chrome 控制台 Failed to fetch 报错解决方案

问题现象

  • 完成PWA全流程配置后,应用的PWA安装、离线访问核心功能可正常运行,仅在Chrome浏览器控制台抛出未捕获Promise异常:Uncaught (in promise) TypeError: Failed to fetch,其他浏览器无同类报错
  • 开发模式下Workbox输出明确关联日志:
    workbox Router is responding to: /
    workbox Network request for '/' threw an error. TypeError: Failed to fetch
    workbox Using NetworkOnly to respond to '/'
    Uncaught (in promise) TypeError: Failed to fetch
    
  • 启动过程中存在命令混用问题:尝试执行拼接的 npm build dev 非标准命令,实际并未按预期完成生产构建,本质仍处于开发调试模式。

问题根因

  • next-pwa 默认会在开发环境下强制注册Service Worker,拦截所有页面请求时,和Next.js的热更新、内存热重载机制存在兼容冲突:开发模式下页面资源频繁热替换,被拦截的 / 路由请求被中断时,Workbox 抛出的异常没有被正确捕获,最终暴露在控制台
  • public目录下留存了手动放置的旧版 sw.js 文件,和next-pwa构建流程自动生成的Service Worker存在版本冲突,导致请求匹配逻辑混乱
  • 部分资源路径存在命名错误,比如public目录下的 icon-512x512.png} 文件名末尾带有多余的右花括号,和manifest中声明的资源路径不匹配,触发资源请求失败

分步修复步骤

  • 修正 next.config.js 中的PWA配置,适配开发/生产环境的差异:
    const withPWA = require('next-pwa')({
      dest: 'public',
      // 开发环境下直接禁用Service Worker注册,避免和热更新逻辑冲突
      disable: process.env.NODE_ENV === 'development',
      // 排除重复生成的SW文件,避免版本冲突
      publicExcludes: ['!sw.js'],
      // 给首页导航路由配置NetworkFirst策略,增加超时兜底,避免未捕获的fetch异常
      runtimeCaching: [
        {
          urlPattern: '/',
          handler: 'NetworkFirst',
          options: {
            networkTimeoutSeconds: 2,
            cacheName: 'start-page-cache',
            expiration: {
              maxEntries: 1,
              maxAgeSeconds: 60 * 60 * 24 // 首页资源缓存24小时
            }
          }
        }
      ]
    })
    
    module.exports = withPWA({
      // 保留原有Next.js的自定义配置
    })
    
  • 清理public目录下的残留文件
    • 删除目录下手动留存的旧 sw.js 文件,避免和构建自动生成的SW版本冲突
    • 修正错误命名的文件,把带多余后缀的 icon-512x512.png} 改回标准名称,确保和manifest中声明的图标路径完全匹配
  • 修正启动命令,不要混用不同模式的参数
    • 日常开发调试时执行 npm run dev,此时因配置了开发环境禁用SW的逻辑,控制台不会出现Workbox相关的拦截日志
    • 生产环境验证PWA功能时,先执行 npm run build 完成生产构建,再执行 npm start 启动服务
  • 清理Chrome端的旧版Service Worker残留
    打开Chrome开发者工具 → 应用面板 → Service Workers 标签页,点击「Unregister」注销当前站点所有已缓存的旧SW,再刷新页面验证,避免旧SW的拦截逻辑残留导致的fetch异常

配置完成后可在Chrome开发者工具的「应用 → 应用清单」面板验证PWA合规性,确认离线访问、安装弹窗功能正常。

内容的提问来源于stack exchange,提问作者Juan Pablo Betancourt

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 15:24:02