Google Calendar扩展触发器失效及重复触发问题求助

核心问题诊断 #

当前代码存在两个关键问题导致触发器失效和潜在重复触发风险：

1. 触发器状态不一致：当系统意外删除触发器（如权限变更、自动清理），PropertiesService中保存的旧触发器ID仍存在，代码会错误判定触发器有效，不再创建新触发器，最终导致几天后功能失效。
2. 未清理无效触发器：现有逻辑仅跳过新触发器创建，既未删除可能存在的无效/旧触发器，也未处理Properties中留存的无效ID。

另外，之前的循环触发问题需要在事件处理函数中加入自识别逻辑，避免处理扩展自身创建的事件。

修复后的触发器管理代码 #

function createTrigger() {
  try {
    console.log("Starting trigger setup");
    const currentUser = Session.getActiveUser()?.getEmail();
    if (!currentUser) {
      console.log("Unable to retrieve active user");
      return;
    }

    const calendar = CalendarApp.getDefaultCalendar();
    if (!calendar) {
      console.log("No default calendar found for user");
      return;
    }

    const userProps = PropertiesService.getUserProperties();
    const savedTriggerId = userProps.getProperty(`${currentUser}_calendarTrigger`);
    let existingTrigger = null;

    // 验证保存的触发器ID是否实际存在
    if (savedTriggerId) {
      existingTrigger = ScriptApp.getProjectTriggers().find(trigger => 
        trigger.getUniqueId() === savedTriggerId
      );
    }

    // 清理无效状态：旧ID对应触发器不存在则删除ID；旧触发器存在则直接删除
    if (savedTriggerId && !existingTrigger) {
      userProps.deleteProperty(`${currentUser}_calendarTrigger`);
    } else if (existingTrigger) {
      ScriptApp.deleteTrigger(existingTrigger);
      userProps.deleteProperty(`${currentUser}_calendarTrigger`);
    }

    // 创建新触发器并保存ID
    const newTrigger = ScriptApp.newTrigger('onCalendarEventClick')
      .forUserCalendar(calendar.getId())
      .onEventUpdated()
      .create();
    
    userProps.setProperty(`${currentUser}_calendarTrigger`, newTrigger.getUniqueId());
    console.log(`Successfully created trigger: ${newTrigger.getUniqueId()} for user ${currentUser}`);

  } catch (e) {
    console.error(`Trigger setup failed: ${e.message}`);
  }
}

避免循环触发的关键处理 #

在onCalendarEventClick函数中，给扩展创建的事件添加自定义标记，处理时跳过这类事件：

function onCalendarEventClick(e) {
  const event = CalendarApp.getCalendarById(e.calendarId).getEventById(e.eventId);
  if (!event) return;

  // 检查事件是否由当前扩展创建（示例：用描述前缀作为标记）
  const eventDescription = event.getDescription() || "";
  if (eventDescription.startsWith("[MyExtensionCreated]")) {
    console.log("Skipping event created by this extension");
    return;
  }

  // 你的事件处理逻辑...

  // 创建新事件时添加标记，避免循环触发
  const newEvent = CalendarApp.getDefaultCalendar().createEvent(
    "New Event Title",
    new Date(),
    new Date(new Date().getTime() + 3600000),
    {
      description: "[MyExtensionCreated] Auto-generated by My Calendar Extension"
    }
  );
}

额外优化建议 #

• 定期校验触发器：添加每周运行一次的定时触发器，自动执行触发器检查与重建逻辑，防止意外删除导致功能中断。
• 权限确认：确保扩展拥有https://www.googleapis.com/auth/calendar完整权限，避免权限不足导致触发器被系统禁用。

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