Google Apps Script & Sheets 高并发下appendRow()覆盖末行问题求助

开发者阿泽

2026-10-14

1. 该问题的普遍性

这是Google Apps Script社区长期存在的已知问题，大量高并发场景的开发者都遇到过相同的覆盖现象。官方文档标注的appendRow()原子性仅适用于极低并发（单实例或每秒并发低于5次）的场景，高并发下的原子性保证实际是失效的。
底层原因是GAS服务端的工作表行号缓存没有在多实例间实时同步，多个并发实例会同时读取到相同的最后一行行号，同时向同一行位置写入数据，最终导致后写入的内容覆盖先写入的内容。

2. 可行的解决方案

方案一：优化Lock Service的使用逻辑

不要直接调用tryLock()后直接操作，增加超时重试和随机等待逻辑，可覆盖绝大多数并发场景：

/**
 * 安全的appendRow封装，支持高并发场景
 * @param {SpreadsheetApp.Sheet} sheet 目标工作表对象
 * @param {Array} rowData 要追加的行数据
 * @return {Boolean} 写入是否成功
 */
function safeAppendRow(sheet, rowData) {
  const lock = LockService.getScriptLock();
  let retryCount = 0;
  const maxRetryTimes = 5;

  while (retryCount < maxRetryTimes) {
    try {
      // 拉长锁等待时间到30秒
      if (lock.tryLock(30000)) {
        sheet.appendRow(rowData);
        lock.releaseLock();
        return true;
      }
    } catch (err) {
      // 捕获锁服务异常，进入重试逻辑
    }
    // 随机等待100-500毫秒再重试，避免羊群效应
    Utilities.sleep(Math.floor(Math.random() * 400) + 100);
    retryCount++;
  }
  // 重试全部失败可自定义异常处理逻辑，比如暂存到服务属性
  return false;
}

方案二：高并发场景下改用批量写入

如果每秒写入请求超过20次，建议先将待写入数据暂存到Properties Service或者云存储服务，再用定时触发器每1-5分钟批量把数据同步到工作表，完全规避并发写入冲突。

方案三：使用Sheets API的append接口替代内置方法

Sheets API的append操作原子性远高于GAS内置的appendRow()，调用时指定插入模式为新增行即可，不会出现覆盖问题。

3. 你遗漏的核心关键点

官方文档描述的appendRow()原子性有隐藏的适用前提，未明确说明高并发场景下不生效，属于文档描述和实际实现不一致的问题。
你之前使用Lock Service时没有增加重试逻辑，锁获取超时后实例直接调用appendRow()，自然就会出现覆盖问题。
该问题和GAS服务端的底层实现有关，不是你代码逻辑的问题，不需要调整业务写入逻辑本身。

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