MV3版Chrome扩展Service Worker重启后无法接收事件问题

问题概述 #

开发MV3版Chrome扩展时，出现以下问题：

• 扩展运行约20分钟后完全失效，不再接收任何已注册的事件（webRequest、tabs.onUpdated、webNavigation等）
• 手动重启扩展或Service Worker后恢复正常，但Chrome自动重启Service Worker后，仅能看到"Main"启动日志，所有事件触发无响应

复现代码 #

console.log("Main");
chrome.webRequest.onBeforeRedirect.addListener(
    async (details) => {
        console.debug(details);
    },
    { urls: ["https://*/*"] }
);
chrome.webRequest.onBeforeRequest.addListener(
    async (details) => {
        console.debug(details);
    },
    { urls: ["https://*/*"] },
    ["requestBody"]
);
chrome.tabs.onUpdated.addListener(
    (tabId, changeInfo, tab) => {
        console.debug(changeInfo);
    }
);
chrome.webNavigation.onDOMContentLoaded.addListener(
    (details) => {
        console.debug(details);
    }
);

核心原因 #

Chrome的Service Worker会因闲置超时（通常5分钟左右）被自动终止，当后续有事件触发时会重新唤醒Service Worker。但MV3中存在已知兼容性问题：自动重启后的Service Worker，其事件监听器可能无法正确绑定到Chrome的事件分发系统，尤其是同时注册多种类型事件时，绑定丢失概率更高。

解决方案 #

1. 移除事件回调的async声明 #

webRequest等事件的回调使用async会干扰Chrome的事件处理逻辑，建议将异步逻辑封装在同步回调内部：

chrome.webRequest.onBeforeRequest.addListener(
    (details) => {
        // 异步逻辑放在立即执行函数中执行
        (async () => {
            console.debug(details);
            // 其他异步操作
        })();
    },
    { urls: ["https://*/*"] },
    ["requestBody"]
);

2. 确保监听器在同步代码中注册 #

所有事件监听器必须放在Service Worker的顶层同步代码中，避免在异步函数或Promise回调中注册，确保每次Service Worker启动时都能立即完成绑定。

3. 添加心跳机制（临时规避） #

通过定时任务防止Service Worker被闲置终止，适合对资源消耗不敏感的场景：

// 每4分钟触发一次心跳，避免Service Worker被闲置终止
chrome.alarms.create("keepAlive", { periodInMinutes: 4 });
chrome.alarms.onAlarm.addListener((alarm) => {
    if (alarm.name === "keepAlive") {
        console.log("Service Worker keepalive");
    }
});

注意：此方法会增加浏览器资源占用，仅作为临时 workaround，不建议长期依赖。

4. 检查Manifest权限声明 #

确保manifest.json中已正确声明所有所需权限：

{
    "manifest_version": 3,
    "permissions": [
        "webRequest",
        "tabs",
        "webNavigation"
    ],
    "host_permissions": ["https://*/*"]
}

5. 升级Chrome到最新版本 #

部分旧版Chrome的MV3存在Service Worker事件绑定bug，升级到最新稳定版可修复大部分已知问题。

验证步骤 #

1. 修改代码后重新加载扩展
2. 等待20分钟以上，或手动在chrome://serviceworker-internals/?devtools中终止Service Worker
3. 触发对应事件（如打开新标签页、访问HTTPS网站）
4. 查看Service Worker日志，确认事件详情正常输出

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