GAS Webアプリの「同時呼び出しの数が多すぎます: スプレッドシート」対策

症状

複数人が同時に使うGoogle Apps Script製のWebアプリ（doGetで配信しgoogle.script.runでRPCするタイプ）で、 ある瞬間から特定の画面だけ以下のようなエラーが表示されるようになる。

エラー: 同時呼び出しの数が多すぎます: スプレッドシート

(英語環境では Too many simultaneous invocations: Spreadsheet)

原因

これはアプリ固有のバグではなく、同じスプレッドシートに対して複数の実行（＝複数ユーザーの同時アクセス）が 短時間に集中したときにGoogle Apps Script側が出すクォータ制限エラー。

特に次の条件が揃うと発生しやすい:

• SpreadsheetApp.openById(SAME_ID) を呼ぶ関数がコード内の多数箇所（十数〜数十箇所）に散らばっている
• 1回の画面ロードでクライアントが複数の google.script.run を並行に発火する
• 1つのサーバー関数の中で、同じスプレッドシートを目的別に何度も開き直している（例: 案件シートを開いた後、 別の関数を呼んでマスタシートをもう一度開く、など）
• アプリの利用者が複数人おり、業務のピーク時間帯にアクセスが重なる

これらが重なると、瞬間的な同時実行数がGAS側の上限に触れ、リトライ処理が無いコードではそのまま ユーザーにエラーが表示されてしまう。

切り分け方

1. エラーメッセージに「同時呼び出し」「simultaneous」が含まれるか確認する（サーバー側の一時的な クォータエラーである可能性が高いサイン。恒常的な権限エラーや構文エラーとは性質が違う）。
2. コード内で同じスプレッドシートIDに対する SpreadsheetApp.openById(...) の呼び出し箇所数を数える （grep -c "SpreadsheetApp.openById" *.gs）。1桁で収まっていれば別原因の可能性が高い。
3. 複数人が同時にアプリを操作するタイミング（始業直後・繁忙時間帯など）で再現するかをヒアリングする。 単独利用時には再現しないことが多い。

対策: リトライ付きラッパー関数に一括置換する

.gs ファイルの冒頭に以下のヘルパーを追加する。

// スプレッドシートを開く（同時アクセス過多エラーに備えてリトライ）
function openSSWithRetry_(id) {
  var maxRetries = 4;
  var delays = [300, 800, 1500, 3000]; // ms, 徐々に長く
  for (var i = 0; i < maxRetries; i++) {
    try {
      return SpreadsheetApp.openById(id);
    } catch (e) {
      var msg = String(e && e.message || e);
      var isQuotaError = msg.indexOf('同時呼び出し') !== -1 || msg.indexOf('simultaneous') !== -1;
      if (!isQuotaError || i === maxRetries - 1) throw e;
      Utilities.sleep(delays[i] + Math.floor(Math.random() * 200)); // 軽いジッター
    }
  }
}

その上で、ファイル内の SpreadsheetApp.openById(...) をすべて openSSWithRetry_(...) に機械的に置換する （正規表現 SpreadsheetApp\.openById\( → openSSWithRetry_( で安全に一括置換できる。FormApp.openById など他のサービスは対象外）。

ポイント:

• クォータエラー以外（構文エラー・権限エラー・存在しないID等）はリトライせず即座に再スローする。 無関係なエラーまでリトライすると原因究明が遅れる。
• 待機時間は徐々に伸ばす（300ms→800ms→1500ms→3000ms）と、短い衝突は数百msで解消し、 重い衝突でも数秒以内に解消することが多い。
• ジッター（ランダムな遅延の上乗せ）を入れることで、複数の実行が同時にリトライしてまた衝突する 「再衝突」を避けやすくなる。
• 既存の try/catch で独自のエラーメッセージに変換している箇所は、内側の openById 呼び出しだけを 置換し、外側の catch ロジックは変更しない。

適用後の確認

• 構文チェック（node --check。.gsは.jsに拡張子を変えてチェックすればよい）
• デプロイ後、ソースをclasp pullし直してローカルファイルとバイト単位で一致することを確認する （デプロイの取りこぼしを防ぐ）
• 実際に複数人で同時に操作してもらい、エラーが再現しないことを確認する

応用

• 同じ問題は DriveApp, FormApp など他のGASサービスでも構造的には起こりうる（当該サービス名を エラーメッセージから読み取り、同じパターンのラッパーを用意すればよい）。
• 1回のリクエストで同じスプレッドシートを何度も開き直している場合は、リトライ対策に加えて 「サーバー関数内でSpreadsheetオブジェクトを使い回す」「読み取り専用データはCacheServiceで 数十秒キャッシュする」ことで、そもそもの同時オープン回数自体を減らせる。