Chrome扩展V2转V3：externally_connectable场景下Service Worker未异常原因咨询

你的场景之所以能正常运行，核心原因是外部网站的消息/连接请求会主动唤醒或维持Service Worker的活跃状态，且你的代码逻辑完全基于事件驱动，不依赖Service Worker的持久化内存状态。以下是具体解释：

1. 外部消息/连接对Service Worker的唤醒机制 #

当你的网站通过chrome.runtime.sendMessage或chrome.runtime.connect向扩展发送请求时：

• Chrome会自动检查扩展的Service Worker状态：如果已被卸载，会立即唤醒它；如果处于闲置状态，会将其标记为活跃。
• 对于connect建立的长端口连接，只要连接未断开，Service Worker会一直保持活跃（Chrome不会在有活跃端口连接时卸载Service Worker）。
• 对于sendMessage这类一次性请求，Chrome会确保Service Worker完成消息处理后，再根据闲置规则判断是否卸载。

你的代码逻辑刚好契合这个机制：

• chrome.runtime.onMessageExternal和chrome.runtime.onConnectExternal的监听是在Service Worker启动时注册的（每次唤醒都会重新执行脚本注册监听），所以即使之前被卸载，新的请求也能触发监听。
• 端口连接时保存的messageExternalPort变量，仅在连接存续期间有效，而连接断开时你会主动将其置空，避免了状态残留问题。

你的Manifest配置：

"externally_connectable": {
  "matches": [
    "*://localhost/*",
    "https://*.bla.com/*"
  ]
}

背景脚本监听逻辑：

chrome.runtime.onMessageExternal.addListener( (message, sender, sendResponse) => {
    log('received external message', message);
});

chrome.runtime.onConnectExternal.addListener(function(port) {
    messageExternalPort = port;

    if (messageExternalPort && typeof messageExternalPort.onDisconnect === 'function') {
        messageExternalPort.onDisconnect(function () {
            messageExternalPort = null;
        })
    }
});

网站侧交互代码：

// 发送消息
chrome.runtime.sendMessage(EXTENSION_ID, { type: "collect" });

// 建立连接并监听消息
const setUpExtensionListener = () => {
    // Connect to chrome extension
    this.port = chrome.runtime.connect(EXTENSION_ID, { name: 'query' });

    // Add listener
    this.port.onMessage.addListener(handleExtensionMessage);
}

2. Chrome Service Worker的官方卸载规则 #

Chrome官方文档明确了Service Worker的卸载条件（没有固定的5分钟/30秒阈值，而是动态调整）：

• 当Service Worker没有任何活跃事件或挂起任务时（包括：活跃的端口连接、未完成的异步操作、定时器、监听的事件触发等）。
• 从最后一个活跃事件结束后，经过一段系统资源相关的闲置时间（Chrome会根据当前内存、CPU使用情况决定何时卸载，文档仅描述为"some time after the last event"）。

需要注意的是：Service Worker的内存状态（比如你代码中的全局变量messageExternalPort）会在卸载后完全丢失，但你的场景中不需要依赖这些状态的持久化——每次请求都会重新唤醒Service Worker，重新注册监听，所以不会影响功能。

3. 为什么其他开发者会遇到问题？ #

多数开发者的问题集中在依赖Service Worker持久化内存状态：

• 比如在V2的持久化背景页中，全局变量用来保存用户会话、长时间运行的定时器或缓存数据；迁移到MV3后，Service Worker闲置卸载会导致这些状态丢失，必须改用chrome.storage.local、chrome.storage.session等持久化存储方案。
• 而你的扩展完全是事件驱动的：所有逻辑都由外部消息/连接触发，不需要在Service Worker闲置时保留状态，因此无需修改即可正常运行。

官方文档参考 #

• Chrome扩展Service Worker核心说明：Service Worker是事件驱动的后台脚本，无活跃事件时会被终止，所有内存状态仅在运行期间有效，重启后需重新初始化。
• externally_connectable交互规则：外部网站发送的消息会触发扩展Service Worker的对应事件，自动唤醒Service Worker处理请求。

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