如何避免多人打开Google Sheets时onOpen触发sortSheet重复执行

架构老林

2026-7-23

Google表格onOpen函数优化：仅无其他用户时执行排序

有一份共享给约100名编辑的Google表格，当前onOpen()函数会调用sortSheet()等功能。但每次有用户打开工作簿时，sortSheet()都会自动执行，导致正在使用表格的用户频繁遇到表格被重复排序的问题。需求是：仅当工作簿没有其他用户打开时，才执行sortSheet()；其余重要操作无论有多少并发实例都必须执行。

实现方案

由于Google Apps Script没有直接获取当前在线用户的API，我们可以通过全局属性锁+时间戳过期的方式模拟“工作簿是否被占用”的检测逻辑：

function onOpen(e) {
  const scriptProps = PropertiesService.getScriptProperties();
  const lockTimestamp = scriptProps.getProperty('workbookLocked');
  const currentTime = new Date().getTime();
  // 设置锁的过期时长为1小时（3600000毫秒），可按需调整
  const lockExpiry = 3600000;

  // 检查锁是否不存在，或已过期
  if (!lockTimestamp || (currentTime - parseInt(lockTimestamp) > lockExpiry)) {
    // 仅在无有效锁时执行排序
    sortSheet();
    // 更新锁的时间戳，标记工作簿已被打开
    scriptProps.setProperty('workbookLocked', currentTime.toString());
  }

  // 以下操作无论并发数多少都会执行
  doOtherCriticalOperations();
}

// 示例：其余重要操作函数
function doOtherCriticalOperations() {
  // 在这里编写你的核心业务逻辑，比如加载自定义菜单、初始化数据等
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('自定义工具')
    .addItem('导出数据', 'exportData')
    .addToUi();
}