Chrome扩展MV2升级MV3时旧版注册SW致onInstalled不触发

升级时chrome.runtime.onInstalled不触发的核心原因，是MV2版本中手动注册的同源自定义Service Worker（即代码中scope为/的myWorker.js），和MV3扩展自身的后台Service Worker产生了注册冲突。
Chrome在执行MV2到MV3的升级流程时，需要先注册扩展自身的后台Service Worker。如果旧版本已经在扩展同源下注册了同scope的自定义Service Worker，会导致扩展SW的启动、事件监听绑定流程被阻塞，等SW完成初始化时，onInstalled事件已经派发完毕，自然无法被捕获。这也和你观察到的现象完全吻合：注释掉MV2里的自定义SW注册代码后，升级流程没有冲突，事件就能正常触发。
注意：你后续在main.js里给扩展SW绑定原生self.addEventListener('install')的写法是错误的。这个是普通网页Service Worker的生命周期事件，和Chrome扩展体系的chrome.runtime.onInstalled不属于同一套事件机制，绑定该事件反而会干扰扩展SW的正常生命周期调度，这段代码必须删除。

按以下步骤修改即可解决问题，同时覆盖事件漏触发的兜底场景：

• 第一步：在MV3后台SW启动的最优先位置，清理旧版本残留的自定义SW注册
  修改worker_wrapper.js，在加载业务脚本之前先执行清理逻辑，把旧版本注册的自定义SW全部卸载：

  // 优先清理MV2版本残留的自定义Service Worker注册
  if ('serviceWorker' in navigator) {
    navigator.serviceWorker.getRegistrations().then(regs => {
      for (const reg of regs) {
        if (reg.scope.startsWith(chrome.runtime.getURL('/'))) {
          reg.unregister();
        }
      }
    });
  }
  
  try {
    importScripts('/script/main.js');
  } catch (e) {
    console.error(e);
  }
  

• 第二步：重构迁移逻辑为幂等逻辑，增加顶层兜底检查，避免依赖单一事件触发
  修改main.js，把迁移逻辑抽成可重复执行无副作用的函数，除了绑定onInstalled监听之外，在脚本顶层直接执行一次检查，覆盖事件漏发的场景：

  chrome.runtime.onInstalled.addListener(handleInstalled);
  
  function handleInstalled(details) {
    console.log('触发onInstalled事件，原因：', details.reason);
    if (details.reason === "install") {
      console.log('扩展首次安装');
    } else if (details.reason === "update") {
      runMigrationCheck(details.previousVersion);
    }
  }
  
  // 幂等迁移检查：重复执行不会重复触发迁移
  function runMigrationCheck(previousVersion = '0.0.0.0') {
    chrome.storage.local.get(['storConvertVer'], (res) => {
      const currentVer = chrome.runtime.getManifest().version;
      // 已经完成当前版本的迁移，直接退出
      if (res.storConvertVer === currentVer) return;
  
      const pvNum = previousVersion.replace(/\./g, '');
      // 小于0.0.0.2的版本需要执行localStorage迁移
      if (pvNum < '0002') {
        chrome.tabs.create({url: chrome.runtime.getURL('convertStorage.html')});
      }
    });
  }
  
  // 顶层兜底执行一次检查，覆盖onInstalled因SW启动慢漏触发的场景
  runMigrationCheck();
  
  // ！！！删除之前添加的self.addEventListener('install')相关代码，不要监听SW原生install事件
  

• 第三步：对齐迁移完成标记字段，避免重复触发迁移
  你原来的检查逻辑用了storageConverted字段，但迁移完成后写入的是storConvertVer，字段不匹配会导致每次SW启动都重复打开迁移页。现有convertStorage.js的迁移逻辑本身没问题，只要确保迁移完成后写入的storConvertVer字段和检查逻辑对齐即可，不需要额外修改其他逻辑。

• MV3的后台Service Worker上下文本身没有localStorage访问权限，你把迁移逻辑放在独立标签页convertStorage.html中执行的方案是完全正确的，不要尝试直接在后台SW中读取localStorage，会直接抛出异常。
• 迁移完成后调用chrome.runtime.reload()是合理操作，重载后旧的自定义SW已经被清理，后续版本升级不会再出现同类冲突问题。
• 禁止在MV3扩展的后台SW中手动注册额外的自定义Service Worker，否则会持续出现生命周期冲突、事件不触发的异常。

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