如何限制Google Apps Script中函数并行执行以避免数据覆盖？

方案1：使用Lock Service实现互斥执行 #

Google Apps Script内置的LockService是解决这类并发竞态问题的官方方案，它能确保同一时间只有一个函数实例进入写入数据的临界代码块。

具体实现逻辑：

• 在触发函数开头获取脚本锁，设置合理的等待超时时间（比如10秒）
• 只有成功获取锁后，才执行检查单元格颜色、写入Supplier Sheet的操作
• 无论执行成功或失败，都要释放锁（用try-finally保证）

代码示例：

function onChangeHandler(e) {
  // 获取脚本锁，最多等待10秒
  const lock = LockService.getScriptLock();
  if (!lock.tryLock(10000)) {
    // 超时未获取锁，直接退出
    console.log("当前有其他任务执行，本次操作跳过");
    return;
  }

  try {
    // 调用check函数验证单元格是否为绿色
    const isGreen = check(e);
    if (isGreen) {
      const masterSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Master Sheet");
      const supplierSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Supplier Sheet");
      
      // 获取当前编辑行的数据
      const targetRow = e.range.getRow();
      const rowData = masterSheet.getRange(targetRow, 1, 1, masterSheet.getLastColumn()).getValues()[0];
      
      // 写入Supplier Sheet的下一行
      const lastRow = supplierSheet.getLastRow();
      supplierSheet.getRange(lastRow + 1, 1, 1, rowData.length).setValues([rowData]);
    }
  } catch (error) {
    console.error("执行出错：", error);
  } finally {
    // 强制释放锁
    lock.releaseLock();
  }
}

function check(e) {
  // 检查单元格背景色是否为绿色（注意：不同主题下绿色的十六进制值可能不同，这里用标准绿色#00ff00示例）
  const cellColor = e.range.getBackground();
  return cellColor === "#00ff00";
}

这个方案从根源上避免了并发写入冲突，因为同一时间只有一个执行能进入写入环节，后续执行会等待锁释放后再获取最新的最后行号。

方案2：使用Properties Service实现任务队列 #

如果担心锁等待导致部分执行被跳过，可以用Properties Service暂存待处理的行号，再通过时间驱动触发器批量处理，彻底规避并发问题。

实现步骤：

1. 在onChange触发器中，仅将符合条件的行号存入队列，不直接写入Supplier Sheet
2. 创建一个时间驱动触发器（比如每1分钟执行一次），批量读取队列中的行号并写入
3. 处理完成后清空队列

代码示例：

function onChangeHandler(e) {
  const isGreen = check(e);
  if (isGreen) {
    const targetRow = e.range.getRow();
    // 获取脚本属性存储队列
    const props = PropertiesService.getScriptProperties();
    let queue = JSON.parse(props.getProperty("rowQueue") || "[]");
    
    // 避免重复添加同一行（可选）
    if (!queue.includes(targetRow)) {
      queue.push(targetRow);
      props.setProperty("rowQueue", JSON.stringify(queue));
    }
  }
}

function processRowQueue() {
  const props = PropertiesService.getScriptProperties();
  const queue = JSON.parse(props.getProperty("rowQueue") || "[]");
  if (queue.length === 0) return;

  const masterSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Master Sheet");
  const supplierSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Supplier Sheet");
  
  // 批量获取待处理行的数据
  const rowData = queue.map(rowNum => {
    return masterSheet.getRange(rowNum, 1, 1, masterSheet.getLastColumn()).getValues()[0];
  });
  
  // 一次性写入Supplier Sheet
  const lastRow = supplierSheet.getLastRow();
  supplierSheet.getRange(lastRow + 1, 1, rowData.length, rowData[0].length).setValues(rowData);
  
  // 清空队列
  props.setProperty("rowQueue", "[]");
}

之后需要手动创建时间驱动触发器，设置processRowQueue函数定期执行（比如每1分钟）。这个方案适合高并发场景，能确保所有符合条件的行都被处理，不会因锁等待被跳过。

为什么之前的检查空行方案无效？ #

你之前的方案属于乐观锁思路，但在GAS并发执行场景下，两个函数实例可能同时通过“目标行是否为空”的判断，随后几乎同时写入同一行，这是典型的竞态条件，无法从根本上解决问题。而Lock Service属于悲观锁，直接阻止并发进入临界区，能彻底规避这种情况。

内容的提问来源于stack exchange，提问作者Sai Nirman Biocoal