GASのLockServiceで
処理の二重実行・競合を防ぐ方法

function appendRowSafely(values) {
  const lock = LockService.getScriptLock();
  // 最大30秒までロック取得を待つ。取れなければ例外になる
  lock.waitLock(30000);
  try {
    const sheet = SpreadsheetApp.getActive().getSheetByName("受付");
    sheet.appendRow(values);
    SpreadsheetApp.flush(); // 変更を確実に書き込んでから解放する
  } finally {
    lock.releaseLock(); // 成功・失敗にかかわらず必ず解放
  }
}

function processOnce() {
  const lock = LockService.getScriptLock();
  // 5秒だけ待って取れなければ、今回はスキップ（多重起動の握りつぶし）
  if (!lock.tryLock(5000)) {
    Logger.log("別の実行が処理中のためスキップしました");
    return;
  }
  try {
    doHeavyJob();
  } finally {
    lock.releaseLock();
  }
}

// 連番（伝票番号）を競合なく採番する
function issueOrderNumber() {
  const lock = LockService.getScriptLock();
  lock.waitLock(30000);
  try {
    const props = PropertiesService.getScriptProperties();
    const current = Number(props.getProperty("orderSeq") || "0");
    const next = current + 1;
    props.setProperty("orderSeq", String(next));
    // 例: 2026-000123 のように整形して返す
    return "2026-" + String(next).padStart(6, "0");
  } finally {
    lock.releaseLock();
  }
}

// 在庫を引き当てる。ロックが無いと在庫がマイナスになりうる
function reserveStock(productId, qty) {
  const lock = LockService.getScriptLock();
  lock.waitLock(30000);
  try {
    const sheet = SpreadsheetApp.getActive().getSheetByName("在庫");
    const data = sheet.getDataRange().getValues();
    for (let i = 1; i < data.length; i++) {
      if (data[i][0] === productId) {
        const stock = Number(data[i][1]);
        if (stock < qty) {
          return { ok: false, reason: "在庫不足", stock };
        }
        sheet.getRange(i + 1, 2).setValue(stock - qty);
        SpreadsheetApp.flush();
        return { ok: true, remaining: stock - qty };
      }
    }
    return { ok: false, reason: "商品が見つかりません" };
  } finally {
    lock.releaseLock();
  }
}

// 同じユーザーの二重送信だけを防ぐ（ユーザーごとに別のロック）
function submitForm(payload) {
  const lock = LockService.getUserLock();
  if (!lock.tryLock(3000)) {
    return { ok: false, message: "送信処理中です。少しお待ちください" };
  }
  try {
    saveSubmission(payload);
    return { ok: true };
  } finally {
    lock.releaseLock();
  }
}

// ロック取得〜解放を1か所にまとめる汎用ラッパー
function withScriptLock(timeoutMs, fn) {
  const lock = LockService.getScriptLock();
  if (!lock.tryLock(timeoutMs)) {
    throw new Error("ロックを取得できませんでした（他の処理が実行中）");
  }
  try {
    return fn();
  } finally {
    lock.releaseLock();
  }
}

// 使い方
function example() {
  const result = withScriptLock(30000, () => {
    return issueOrderNumber();
  });
  Logger.log(result);
}