Chrome扩展Manifest V3 Service Worker更新异常解决方案

问题表现 #

该问题是Chrome MV3扩展开发中的常见已知问题：

• 点击扩展管理页的Update按钮，或是勾选Update on reload选项后刷新页面，Service Worker都无法完成更新
• 核心表现为正在运行的旧版Service Worker始终不卸载，新版本Service Worker无法启动运行

解决方法 #

1. 代码层配置强制跳过等待激活 #

在Service Worker入口文件添加生命周期事件监听，让新版本下载完成后直接跳过等待阶段激活，不需要等旧SW自然退出：

self.addEventListener('install', () => {
  // 安装阶段直接触发跳过等待
  self.skipWaiting();
});

self.addEventListener('activate', (event) => {
  // 激活后立刻接管所有扩展相关的上下文，不需要重启浏览器/扩展
  event.waitUntil(self.clients.claim());
});

注意：self.skipWaiting()不要直接写在SW顶层作用域，必须放在install事件回调内，否则会在部分Chrome版本下触发SW启动报错。

2. 开发阶段绕过保活机制的操作 #

开发时遇到更新卡住，几乎都是DevTools保活机制导致的：只要Service Worker的DevTools检查窗口（即你截图中打开的开发者工具面板）处于打开状态，Chrome就会强制禁用SW的空闲自动卸载逻辑，旧SW进程会一直常驻，新版本自然无法加载。对应操作如下：

• 不要依赖扩展管理页的Update按钮和Update on reload选项，这两个逻辑在SW被DevTools附加的场景下本身就存在兼容bug，无法正常触发更新
• 每次改完代码要测试时，先关闭当前打开的Service Worker DevTools窗口，再点击扩展卡片上的圆形「重新加载」按钮，就会强制销毁旧SW进程，启动新版本
• 如果上述操作仍不生效，打开chrome://serviceworker-internals/页面，找到对应扩展ID的Service Worker条目，先点击Stop按钮手动终止旧进程，再回到扩展管理页重新加载扩展即可100%生效。

3. 生产环境说明 #

线上发布的扩展不需要额外做特殊处理，只要代码中添加了上述skipWaiting逻辑，Chrome在自动检测到扩展更新、下载完成新包后，会在旧SW无待处理事件、进入空闲状态时自动完成版本替换，不会出现永久卡在旧版本的问题。

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