MV3 ServiceWorker收到content script消息未唤醒是否正常及解决方法咨询

问题性质判定 #

Service Worker无操作时自动休眠属于平台预期设计，但接收chrome.runtime.sendMessage发送的消息时未被唤醒、无响应不属于预期行为。Chrome扩展运行时默认会在收到跨上下文消息时主动唤醒休眠状态的背景Service Worker，你遇到的异常是代码逻辑疏漏导致的。

核心问题原因 #

你的代码存在两处不符合扩展开发规范的写法，直接导致消息处理失败：

• 给chrome.runtime.onMessage.addListener传入了async回调，但没有显式返回true告知扩展运行时你需要执行异步逻辑，运行时会提前销毁回调上下文，甚至来不及执行clearCookies就终止Service Worker运行
• 如果事件监听没有写在Service Worker脚本的同步执行阶段（比如放在异步回调、DOM加载事件内部），Service Worker被唤醒后无法立即匹配到对应监听函数，会直接回到休眠状态，表现为无响应

修复方案 #

1. 修正背景Service Worker监听逻辑 #

调整background.js代码如下，即可实现「收到消息唤醒、执行完自动休眠」的需求，不需要额外配置持久运行参数：

// 监听必须写在脚本顶层同步执行位置，不能放在任何异步逻辑内部
chrome.runtime.onMessage.addListener(function (request, sender, sendResponse) {
  if(request.message === 'hello'){
    // 如需执行异步逻辑，可包裹在自执行async函数内
    (async () => {
      await clearCookies();
      // 若需要给content script返回结果，可在此调用sendResponse
      // sendResponse({result: 'success'})
    })();
    // 必须返回true，告知运行时存在未完成的异步逻辑，不要提前销毁上下文
    return true;
  }
  // 不处理的消息返回false
  return false;
});

2. 可选：优化消息投递可靠性 #

部分旧版Chrome存在偶发的消息投递失败问题，可在content script侧增加简单的重试逻辑，避免消息丢失：

function sendMessageWithRetry(data, maxRetry = 3, delay = 100) {
  return new Promise((resolve, reject) => {
    chrome.runtime.sendMessage(data, (res) => {
      if (chrome.runtime.lastError) {
        if (maxRetry <= 0) return reject(chrome.runtime.lastError);
        setTimeout(() => {
          sendMessageWithRetry(data, maxRetry - 1, delay).then(resolve).catch(reject);
        }, delay);
        return;
      }
      resolve(res);
    })
  })
}

// 调用方式
sendMessageWithRetry({ message: "hello" });

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