MV3扩展content_script访问chrome.storage.local偶现TypeError报错

这个报错是Chrome扩展重载时的典型上下文失配问题，和Manifest V3的上下文回收机制特性直接相关：

1. 你在chrome://extensions/页面点击重载扩展时，Chrome会立刻销毁旧扩展的所有运行时上下文（包括后台service worker、扩展API访问权限），但已经注入到此前打开的所有网页里的旧版content script不会被自动回收移除。
2. 残留的旧content script继续执行时，原本挂载在window下的chrome.storage对象已经随扩展上下文销毁被回收为undefined，此时链式读取.local属性就会抛出你看到的Cannot read properties of undefined (reading 'local')错误。
3. 你提到的其他偶发无意义报错，本质都是同一个原因：失效的旧content script还在调用已被销毁的Chrome扩展API。

注：Manifest V2时代也存在这个问题，但V3的service worker按需回收、上下文隔离机制更严格，所以重载时该问题的触发概率明显更高。

• 所有Chrome扩展API调用前增加存在性兜底校验，避免直接链式调用触发报错，修改你的代码段如下：

// 校验扩展API上下文是否有效，无效则直接终止逻辑
if (chrome?.storage?.local) {
  chrome.storage.local.get('timeSync', function(result) {
    timeSync = result.timeSync;
  });
}

• 在content script开头增加上下文失效监听，扩展被重载/禁用时主动清理所有残留逻辑，从根源避免无效代码执行：

// 监听扩展运行时连接断开事件
const port = chrome.runtime?.connect({ name: 'content-script-check' });
if (port) {
  port.onDisconnect.addListener(() => {
    if (chrome.runtime.lastError?.message?.includes('Extension context invalidated')) {
      // 此处执行自定义清理逻辑：清除所有定时器、移除DOM事件监听、删除扩展注入的页面元素
      // 简单场景可直接重载页面，让新版扩展的content script重新注入
      location.reload();
    }
  });
}

• 补充核对项：确认manifest.json的permissions字段中已声明"storage"权限，虽然偶现报错基本可以排除权限缺失问题，但可以避免其他场景下的必现报错。

该问题仅会在开发阶段重载扩展、或用户手动禁用/启用扩展时触发，普通用户正常使用过程中几乎不会遇到，加上上述校验后即可完全覆盖异常场景。

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