Chrome扩展content script偶发注入失败 需重装扩展修复的问题咨询

偶发注入失败、必须重装扩展才能恢复的问题，是代码逻辑缺陷叠加Chrome近期API行为变更共同导致的：

• 监听器泄漏与事件丢失：Chrome 110及以上版本调整了tabs.onUpdated的事件触发规则，命中往返缓存（bfcache）、预渲染激活、Service Worker托管的页面，不会在chrome.tabs.create调用后按预期触发status === 'complete'事件；极端情况下绑定监听器时页面已经加载完成，监听器会永久残留在后台上下文，多次累积后会触发上下文异常，导致注入逻辑完全失效，只有重载扩展才能重置运行环境恢复功能。
• 缺失错误捕获：现有代码中所有chrome.tabs.executeScript、chrome.tabs.sendMessage调用都没有检查chrome.runtime.lastError，一旦出现注入失败（比如跨域子框架拒绝注入、页面临时跳转到浏览器内置受限地址），会抛出未捕获异常，直接打断后台上下文的执行逻辑，后续所有注入请求都会直接失败。
• 时序逻辑不可靠：status === 'complete'仅代表浏览器原生资源加载完成，不代表DOM结构稳定；同时开启allFrames: true配置时，页面加载完成后动态插入的iframe不会被自动注入脚本，且sendMessage调用时如果对应帧的content script还没完成初始化，消息会直接丢弃，没有任何重试机制。

核心调整点：绑定监听器前先检查tab当前加载状态避免漏事件、所有API调用加错误捕获、注入与消息发送增加重试逻辑、监听器触发后立刻移除避免泄漏：

/**
 * 注入表单填充脚本并发送数据，自带失败重试
 * @param {number} tabId 目标标签页ID
 * @param {object} formData 要填充的表单数据
 * @param {number} retryCount 剩余重试次数
 */
function injectAndSend(tabId, formData, retryCount = 3) {
  chrome.tabs.executeScript(tabId, {
    file: 'library.js',
    allFrames: true,
    runAt: 'document_end'
  }, () => {
    if (chrome.runtime.lastError) {
      if (retryCount > 0) setTimeout(() => injectAndSend(tabId, formData, retryCount - 1), 200);
      return;
    }
    chrome.tabs.executeScript(tabId, {
      file: 'fillForm.js',
      allFrames: true,
      runAt: 'document_end'
    }, () => {
      if (chrome.runtime.lastError) {
        if (retryCount > 0) setTimeout(() => injectAndSend(tabId, formData, retryCount - 1), 200);
        return;
      }
      chrome.tabs.sendMessage(tabId, { formData }, () => {
        // 消息发送失败时重试，应对脚本初始化延迟问题
        if (chrome.runtime.lastError && retryCount > 0) {
          setTimeout(() => injectAndSend(tabId, formData, retryCount - 1), 150);
        }
      });
    });
  });
}

chrome.tabs.create({ url: url, active: true }, (tab) => {
  // 先检查标签页当前状态，避免绑定监听器过晚错过complete事件
  chrome.tabs.get(tab.id, (tabInfo) => {
    if (tabInfo.status === 'complete') {
      injectAndSend(tab.id, formData);
      return;
    }
    const onTabUpdated = (tabId, info) => {
      if (tabId === tab.id && info.status === 'complete') {
        chrome.tabs.onUpdated.removeListener(onTabUpdated);
        injectAndSend(tab.id, formData);
      }
    };
    chrome.tabs.onUpdated.addListener(onTabUpdated);
  });
});

• 如果扩展已迁移到Manifest V3，建议将chrome.tabs.executeScript替换为chrome.scripting.executeScript，需要在manifest配置中声明scripting权限，新API的注入稳定性远高于旧API，不受旧版事件逻辑的兼容问题影响。
• 不要依赖document_end判断脚本就绪，可以在fillForm.js初始化完成后主动向后台发送contentScriptReady消息，后台收到就绪信号后再传递表单数据，彻底解决消息时序丢失问题。
• 如果需要填充页面动态加载的iframe内容，可以新增chrome.webNavigation.onCompleted监听器，对同标签页下后续加载的子框架自动补注入脚本。

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