Chrome扩展Manifest V3自动更新异常：requestUpdateCheck返回throttled求助

问题背景 #

开发基于Manifest V3的Chrome扩展时，原本通过后端版本对比触发chrome.runtime.requestUpdateCheck()来主动检测更新，该逻辑正常运行数月后突然失效——哪怕单次调用requestUpdateCheck()，也会返回throttled状态，导致chrome.runtime.onUpdateAvailable无法触发，且节流状态会持续数小时直至Chrome自动完成更新。

可能的原因 #

• Chrome全局更新检查限制：Chrome对所有扩展的更新检查有全局频率阈值，并非按单个扩展的调用次数计算。如果浏览器近期已自动执行过更新检查，新的主动请求会被直接节流。
• 测试扩展的特殊处理：未打包的unpacked测试扩展，Chrome的更新机制会有特殊缓存逻辑，容易触发无差别节流。
• Chrome版本更新后的逻辑调整：近期Chrome版本迭代可能收紧了更新检查的节流规则，缩短了允许的请求间隔。
• Service Worker生命周期影响：Manifest V3的Service Worker可能因闲置被终止，重启后若重复执行检查逻辑，会被判定为重复请求触发节流。

解决方案 #

优化检查时机与频率 #

• 避免在Popup打开时频繁触发检查，改为在Service Worker的activate事件中仅执行一次检查，或通过本地存储记录上次检查时间，设置至少1小时的间隔阈值，避免触发全局限制。
• 依赖Chrome原生自动更新机制：Chrome默认几小时会自动检查一次扩展更新，若只是需要提前告知用户，可在版本不一致时直接提示，无需强制调用requestUpdateCheck()。

测试环境适配 #

• 对于unpacked测试扩展，直接在chrome://extensions/页面开启开发者模式，点击「更新」按钮强制触发更新，绕过节流限制。
• 打包扩展上传至Chrome Web Store测试渠道，用正式更新机制验证逻辑，避免测试环境的特殊缓存干扰。

代码层面优化示例（Service Worker版） #

// service-worker.js
async function fetchServerVersion() {
  // 替换为实际后端版本接口请求
  const res = await fetch('https://your-server.com/extension/version');
  const data = await res.json();
  return data.result;
}

async function checkVersion() {
  const { lastCheckTime } = await chrome.storage.local.get('lastCheckTime');
  const now = Date.now();
  // 1小时内跳过重复检查
  if (lastCheckTime && now - lastCheckTime < 3600000) return;

  const serverVersion = await fetchServerVersion();
  const clientVersion = chrome.runtime.getManifest().version;

  if (serverVersion !== clientVersion) {
    chrome.runtime.requestUpdateCheck((status) => {
      console.log(`更新检查状态: ${status}`);
      if (status === 'throttled') {
        // 提示用户手动更新
        chrome.notifications.create({
          type: 'basic',
          iconUrl: 'icon.png',
          title: '扩展更新可用',
          message: '请前往扩展页面点击刷新按钮获取更新'
        });
      }
    });
  }
  // 记录本次检查时间
  await chrome.storage.local.set({ lastCheckTime: now });
}

// 在Service Worker激活时执行版本检查
self.addEventListener('activate', (event) => {
  event.waitUntil(checkVersion());
});

// 全局注册更新监听
chrome.runtime.onUpdateAvailable.addListener((details) => {
  console.log('更新详情:', details);
  chrome.notifications.create({
    type: 'basic',
    iconUrl: 'icon.png',
    title: '扩展已更新',
    message: '请重新加载扩展以应用新版本'
  });
});

替代方案 #

• 直接引导手动更新：当版本不一致时，不调用requestUpdateCheck()，直接在扩展内显示弹窗或通知，引导用户前往Chrome Web Store扩展页面，或打开chrome://extensions/手动刷新。
• 自定义更新源：若扩展未通过Chrome Web Store发布，可在Manifest中配置update_url指定自定义更新XML文件，完全自主控制更新检查逻辑，绕过Chrome的全局节流限制。

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