多独立Google Apps Script修改同一表格的锁同步方案咨询

针对多个独立Google Apps Script共享编辑同一Spreadsheet的场景，基于Document Properties + LockService的分布式锁实现是可靠且高效的解决方案，完全替代之前的单元格信号量方案，具体实现逻辑和优势如下：

核心思路 #

利用绑定目标Spreadsheet的Document Properties存储全局锁状态（所有有权限的独立脚本均可读写），同时结合每个脚本自身的ScriptLock，保证锁状态的检查、修改操作是原子性的，避免竞态条件；额外加入锁超时机制防止死锁，解决独立脚本间的同步问题。

具体实现步骤 #

1. 锁状态存储：通过Spreadsheet.getDocumentProperties()获取文档专属的属性存储，用于记录锁的持有状态（包含持有锁的脚本ID和时间戳）。
2. 原子性保护：每个脚本在读写锁状态前，先获取自身的ScriptLock，确保单脚本内的锁操作不会被中断，避免多个脚本同时修改锁状态导致的冲突。
3. 锁超时处理：记录锁的时间戳，若锁持有时间超过设定阈值（比如5分钟），则强制释放锁，防止脚本崩溃导致的死锁。
4. 重试策略：采用指数退避的重试机制，未获取锁时逐渐增加等待时间，减少资源消耗。
5. 安全释放：释放锁时校验锁的持有者身份，避免误释放其他脚本持有的锁。

示例代码 #

可以将以下通用锁工具函数复制到所有需要同步的独立脚本中：

// 跨脚本共享锁工具：获取指定Spreadsheet的全局锁
function acquireSpreadsheetLock(spreadsheetId, lockKey = "global_spreadsheet_lock", timeoutMs = 30000, maxRetries = 10) {
  const targetSs = SpreadsheetApp.openById(spreadsheetId);
  const docProps = targetSs.getDocumentProperties();
  const scriptLock = LockService.getScriptLock();

  for (let retryCount = 0; retryCount < maxRetries; retryCount++) {
    try {
      // 获取脚本锁，保证锁状态读写的原子性
      if (scriptLock.tryLock(timeoutMs)) {
        const currentLock = docProps.getProperty(lockKey);
        const now = Date.now();
        const lockTimeout = 5 * 60 * 1000; // 锁超时时间：5分钟

        // 锁未被持有，或已超时则抢占锁
        if (!currentLock || (now - parseInt(currentLock.split("_")[1]) > lockTimeout)) {
          const newLock = `${ScriptApp.getScriptId()}_${now}`;
          docProps.setProperty(lockKey, newLock);
          scriptLock.releaseLock();
          
          // 返回带释放方法的锁对象
          return {
            release: () => {
              const releaseLock = LockService.getScriptLock();
              if (releaseLock.tryLock(timeoutMs)) {
                const latestLock = docProps.getProperty(lockKey);
                // 仅释放自身持有的锁
                if (latestLock === newLock) {
                  docProps.deleteProperty(lockKey);
                }
                releaseLock.releaseLock();
              }
            }
          };
        }
        scriptLock.releaseLock();
      }
    } catch (err) {
      console.error("锁操作异常:", err);
      if (scriptLock.hasLock()) scriptLock.releaseLock();
    }

    // 指数退避等待：1s, 2s, 4s...
    Utilities.sleep(Math.pow(2, retryCount) * 1000);
  }

  throw new Error(`获取锁失败，已重试${maxRetries}次`);
}

// 临界区代码使用示例
function runCriticalTask() {
  const SPREADSHEET_ID = "替换为你的目标表格ID";
  let lock = null;

  try {
    // 获取锁
    lock = acquireSpreadsheetLock(SPREADSHEET_ID);
    // --- 临界区开始 ---
    const ss = SpreadsheetApp.openById(SPREADSHEET_ID);
    const sheet = ss.getSheetByName("数据 sheet");
    // 执行需要同步的操作：比如修改单元格、追加数据等
    sheet.getRange("A1").setValue(new Date().toLocaleString());
    // --- 临界区结束 ---
  } catch (err) {
    console.error("临界区执行失败:", err);
  } finally {
    // 确保锁被释放
    if (lock) lock.release();
  }
}

方案优势 #

• 效率更高：Document Properties的读写性能远优于单元格操作，无刷新、等待单元格同步的额外开销。
• 可靠性强：ScriptLock保证锁状态修改的原子性，避免竞态条件；超时机制防止死锁，锁持有者校验避免误释放。
• 实现简洁：无需处理单元格读写的复杂逻辑，代码可复用性高。

注意事项 #

• 确保所有独立脚本都拥有目标Spreadsheet的编辑权限（通过共享设置或OAuth授权）。
• 锁超时时间需根据临界区代码的实际执行时长调整，避免正常执行时锁被强制释放。
• 重试次数和退避时间可根据业务场景灵活修改，平衡等待时长和资源占用。

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