Chrome扩展runtime.onStartup/onSuspend异常及闹钟一致性问题

问题根源拆解 #

1. onSuspend异步操作限制：Chrome会在onSuspend回调执行后立即终止扩展进程，异步API调用（如chrome.alarms.clearAll()）大概率来不及完成，导致旧闹钟残留。
2. onStartup竞态与延迟计算错误：直接用配置间隔作为初始延迟，未考虑浏览器关闭到重启的时间差，导致重启后闹钟立即触发。
3. 后台进程与窗口事件混淆：开启「Continue running background apps when Google Chrome is closed」后，onStartup可能在系统开机时触发（无浏览器窗口），也可能在用户打开窗口时触发，逻辑不一致。

具体解决方案 #

1. 修复onSuspend的清除逻辑

改用状态标记+下次启动兜底的方式，规避异步操作无法完成的问题：

chrome.runtime.onSuspend.addListener(() => {
  // 标记扩展进入挂起状态，留给下次启动处理
  chrome.storage.local.set({ isSuspended: true }, () => {
    // 尝试清除闹钟，即使失败也靠后续逻辑兜底
    chrome.alarms.clearAll();
  });
});

2. 修正onStartup的闹钟初始化逻辑

通过记录闹钟最后触发时间，重新计算合理延迟，避免重启后立即触发：

function createOrUpdateAlarms() {
  chrome.storage.local.get(["timeout", "water", "walk", "lastAlarmTimes", "isSuspended"], (items) => {
    const { 
      timeout, 
      water, 
      walk, 
      lastAlarmTimes = {}, 
      isSuspended 
    } = items;

    // 确保先清除所有旧闹钟
    chrome.alarms.clearAll(() => {
      const now = Date.now();
      const createAlarm = (name, interval) => {
        let delayInMinutes;
        if (isSuspended && lastAlarmTimes[name]) {
          // 计算上次触发到现在的时间差，推导下次触发的剩余延迟
          const timeSinceLast = (now - lastAlarmTimes[name]) / 60000;
          const remaining = interval - (timeSinceLast % interval);
          // 避免延迟过短（≤1分钟）导致立即触发，直接设为完整间隔
          delayInMinutes = remaining <= 1 ? interval : remaining;
        } else {
          delayInMinutes = interval;
        }

        chrome.alarms.create(name, {
          delayInMinutes: delayInMinutes,
          periodInMinutes: interval,
        });
        // 更新当前闹钟的最后创建/触发时间
        chrome.storage.local.set({
          [`lastAlarmTimes.${name}`]: now
        });
      };

      if (timeout) createAlarm(Alarms.ScreenBreak, timeout);
      if (water) createAlarm(Alarms.Water, water);
      if (walk) createAlarm(Alarms.Walk, walk);

      // 清除挂起状态标记
      chrome.storage.local.remove("isSuspended");
    });
  });
}

同时，在闹钟触发时更新最后触发时间，确保状态准确：

chrome.alarms.onAlarm.addListener((alarm) => {
  // 此处添加你的闹钟触发逻辑（如通知、弹窗等）
  // 更新当前闹钟的最后触发时间
  chrome.storage.local.set({
    [`lastAlarmTimes.${alarm.name}`]: Date.now()
  });
});

3. 统一浏览器启停的事件逻辑

通过检测窗口数量，区分「系统开机启动后台进程」和「用户打开浏览器窗口」场景：

chrome.runtime.onStartup.addListener(() => {
  chrome.windows.getAll({ populate: false }, (windows) => {
    // 按需调整逻辑：true=开机即启动闹钟；false=仅打开浏览器窗口时启动
    const shouldInitAlarms = windows.length > 0 || true;
    if (shouldInitAlarms) {
      console.log("Fired on startup", new Date());
      createOrUpdateAlarms();
    }
  });
});

额外监听窗口创建事件，确保后台进程存活时打开新窗口也能初始化闹钟：

chrome.windows.onCreated.addListener(() => {
  chrome.alarms.getAll((alarms) => {
    if (alarms.length === 0) {
      createOrUpdateAlarms();
    }
  });
});

4. 处理后台进程存活场景

当最后一个浏览器窗口关闭时，主动清除闹钟或标记挂起：

chrome.windows.onRemoved.addListener((windowId) => {
  chrome.windows.getAll({ populate: false }, (windows) => {
    if (windows.length === 0) {
      chrome.storage.local.set({ isSuspended: true }, () => {
        chrome.alarms.clearAll();
      });
    }
  });
});

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