Chrome扩展Manifest V3：已调度Alarms但onAlarm未触发的问题求助

问题描述 #

基于Manifest V3开发的Chrome扩展，在主Service Worker脚本中配置了两个定时Alarms：一个每分钟运行一次，另一个每20分钟运行一次，同时注册了onAlarm事件监听器。

但偶尔（暂未发现明确复现规律），扩展会完全停止响应Alarms，onAlarm对应的代码不再被调用，即便设置无延迟触发也无效。问题通常在数小时或数天后出现，推测与电脑休眠有关。

已确认信息 #

• 在Service Worker控制台执行chrome.alarms.getAll(console.log)，确认两个Alarms已正确配置，均显示正常的下次计划运行时间；
• 通过chrome://extensions-internals页面及chrome.alarms.onAlarm.hasListeners()方法，确认扩展已成功注册Alarm监听器。

进一步观测细节 #

• Alarms虽未触发可观测的Alarm事件，但仍按预期重复调度，总能正确设置下一次的运行时间；
• 新增的Alarm监听器（如chrome.alarms.onAlarm.addListener(console.info)）同样不会被触发；
• 新增的Alarm（如chrome.alarms.create("hello", { delayInMinutes: 1})）无任何反馈，直接消失；
• 手动触发Alarm事件（如chrome.alarms.onAlarm.dispatch({name: "yo"})）时，所有已注册的处理器均可正常运行；
• 扩展未抛出任何错误信息。

疑问 #

1. 导致该现象的原因可能是什么？为何Alarms已正确调度，但除手动触发外无法触发onAlarm？
2. 如何捕捉该行为并确保Alarms恢复正常？

问题原因分析 #

这种现象本质是Manifest V3中Service Worker的意外失活或事件通道异常导致：

1. Service Worker休眠/回收后的状态异常：Chrome会自动回收闲置的Service Worker，电脑休眠唤醒后，Service Worker可能被恢复但内部事件绑定通道断裂。Alarms的调度逻辑由浏览器维护，所以仍能更新下次运行时间，但浏览器无法将Alarm事件传递到Service Worker的监听器中。
2. 事件总线隐性故障：浏览器内部事件分发机制在长时间运行或休眠唤醒后可能出现异常，导致Alarms事件无法触发Service Worker中注册的监听器，但手动调用dispatch绕开了浏览器的事件分发通道，因此能正常执行。

解决方案：捕捉异常并恢复功能 #

1. 实现心跳检测机制 #

利用短周期Alarm和状态检查判断异常：

• 保留原有Alarm，新增每30秒一次的心跳Alarm，维护全局心跳计数器；
• 在onAlarm监听器中更新计数器，每2分钟检查计数器是否更新：若连续两次检查未变化，说明Alarm事件未触发，执行恢复逻辑。

示例代码：

let heartbeatCounter = 0;
const HEARTBEAT_ALARM_NAME = "heartbeat";

// 初始化心跳Alarm
chrome.alarms.create(HEARTBEAT_ALARM_NAME, { periodInMinutes: 0.5 });

// 心跳监听器
chrome.alarms.onAlarm.addListener((alarm) => {
  if (alarm.name === HEARTBEAT_ALARM_NAME) {
    heartbeatCounter++;
  }
  // 处理原有业务逻辑...
});

// 定期检查心跳状态
setInterval(() => {
  const currentCounter = heartbeatCounter;
  // 30秒后再次检查，计数器未变则判定异常
  setTimeout(() => {
    if (heartbeatCounter === currentCounter) {
      resetAlarmsAndListeners();
    }
  }, 31000);
}, 120000); // 每2分钟检查一次

2. 重置Alarms与监听器的恢复逻辑 #

检测到异常时，彻底重置Alarms和监听器：

function resetAlarmsAndListeners() {
  // 移除所有现有监听器
  chrome.alarms.onAlarm.removeListeners();
  // 清除所有现有Alarms
  chrome.alarms.clearAll().then(() => {
    // 重新注册监听器
    chrome.alarms.onAlarm.addListener((alarm) => {
      // 重新绑定原有业务逻辑
      if (alarm.name === HEARTBEAT_ALARM_NAME) {
        heartbeatCounter++;
      }
      // 处理原有两个Alarm的业务逻辑
    });
    // 重新创建所有Alarms
    chrome.alarms.create("minute-alarm", { periodInMinutes: 1 });
    chrome.alarms.create("20min-alarm", { periodInMinutes: 20 });
    chrome.alarms.create(HEARTBEAT_ALARM_NAME, { periodInMinutes: 0.5 });
  });
}

3. 利用runtime.onStartup事件兜底 #

在浏览器启动或扩展重新加载时，确保Alarms和监听器正确初始化：

chrome.runtime.onStartup.addListener(() => {
  resetAlarmsAndListeners();
});

4. 降低Service Worker被回收概率 #

虽然Manifest V3不支持持久化Service Worker，但可通过以下方式减少回收：

• 保持Service Worker有定期事件触发（如心跳Alarm），缩短闲置时间；
• 避免在Service Worker中执行长时间同步操作，防止被判定为无响应而回收。

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