月末の午後、札幌オフィスの経理チームや営業サポートのデスク周りで、こんな冷や汗もののトラブルが起きたことはありませんか?
「あれ……? 私が今発行した『株式会社札幌スープカレー本舗』様向けの請求書番号、INV-1005なんだけど……」
「えっ!? 私が今さっき発行ボタンを押した『道産子フーズ株式会社』様向けの請求書も、まったく同じINV-1005になってるよ!?」
画面を見合わせて一瞬で凍りつく現場。まったく別のクライアントに、まったく同じ請求書番号が重複して発行されてしまった大事故です。
手作業でスプレッドシートを開いて番号を打ち直して、相手に「すみません、請求書の番号が重複していたので再送します」と頭を下げてお詫びメールを送る……。想像するだけで胃がキリキリと痛くなりますよね。
第87回〜第90回で学んだように、Webアプリのダッシュボードに「請求書一括発行ボタン」や「新規登録ボタン」を作ると、業務は劇的にラクになります。しかし、システムが便利になって社内の複数人が同時に使えるようになった瞬間、必ずこの「ボタンの同時クリックによるデータの衝突事故(二重採番・上書き破壊)」という巨大な落とし穴が待ち構えているのです。
夕方のラッシュ時に地下鉄の改札に大勢の人が同時にドッと押し寄せたら、ぶつかって大混乱になりますよね。1人ずつ順番に改札を通るからこそ、スムーズに流れるわけです。
プログラムも全く同じです。
複数人がほぼ同時に「発行ボタン」を押したとき、プログラムに「ちょっと待って! 今はAさんが番号を取っている最中だから、Bさんは1秒だけドアの外で待っててね!」と順番待ちの列を作らせる仕組み。これこそが、今回マスターするGAS最強の守護神「LockService.getScriptLock()(排他制御)」です!
100回連載ロードマップも残すところあと2回となった第99回。今回は、業務システムの信頼性を担保する上で避けては通れない「排他制御(ロック)」の仕組みから、二重採番が起きるメカニズム、try…finally構文を使った鉄壁のコード設計、そして初心者が必ずハマるデッドロックの罠まで、どこよりも分かりやすく丁寧に解説していきます!
1. そもそも LockService とは?なぜ「二重採番」が起きるのか
まずは、「なぜボタンを同時に押すと番号が被ってしまうのか?」という根本的な仕組みと、LockServiceが裏で何をしているのかを紐解いていきましょう!
二重採番が起きる恐怖のメカニズム(レースコンディション)
プログラムの世界では、複数の処理が同じデータに対して同時にアクセスし、競い合うように書き込みを行ってしまう現象を「レースコンディション(競合状態)」と呼びます。
スプレッドシートをデータベースにして請求番号を自動採番する処理を例に、裏側で何が起きているのかを時系列で見てみましょう。
【魔のコンマ数秒:ロックがない世界で起きている大惨事】
14:00:00.100 [営業Aさん] 画面の「請求書発行」ボタンをクリック!
14:00:00.120 [営業Bさん] 偶然ほぼ同時に「請求書発行」ボタンをクリック!
│
14:00:00.200 [処理A] スプレッドシートを見る ➔「現在の最新番号は INV-1004 だな!」
14:00:00.210 [処理B] スプレッドシートを見る ➔「現在の最新番号は INV-1004 だな!」(※Aさんが書く前なので同じ数を見る)
│
14:00:00.300 [処理A] 1004 + 1 =「INV-1005」を生成し、シートに書き込む!
14:00:00.310 [処理B] 1004 + 1 =「INV-1005」を生成し、シートに書き込む!
│
▼
【大事故発生!】
Aさん(札幌スープカレー本舗) ➔ INV-1005 が発番される
Bさん(道産子フーズ) ➔ まったく同じ INV-1005 が発番される!!
どうでしょうか?
Aさんの処理が「スプレッドシートに新しい行を書き込む」よりもほんのコンマ数秒早く、Bさんの処理が「スプレッドシートの最終行を見に行ってしまった」ため、2人ともまったく同じ「1004」をベースに計算をスタートしてしまったのです。
どれだけスプレッドシートの関数を工夫しても、どれだけ高速なサーバーを使っても、「同時に動く」限りこの事故を根本から防ぐことはできません。
LockServiceは「個室トイレの鍵」と同じ!
この同時多発事故をエレガントに防いでくれるのが、GAS標準のLockService(ロックサービス)です。
イメージしてください。オフィスの「1室しかない個室トイレ」や、アパレルショップの「試着室」です。
部屋に入った人は、まず内側から「カチャッ」と鍵(ロック)をかけますよね。
鍵がかかっている間、外に来た次の人は無理やりドアを開けることはできず、ドアの前で「順番待ち」をします。そして中の人が用を足してドアを開け、鍵を解除(リリース)した瞬間に、待っていた次の人が部屋に入って再び鍵をかけます。
【LockServiceを導入した世界:平和な順番待ち】
14:00:00.100 [処理A] GASが「鍵(ロック)」をガチャンと取得!部屋に入る。
14:00:00.120 [処理B] GASが動くが、鍵がかかっているのでドアの外で「待機」する。
│
14:00:00.200 [処理A] 安心してシートを確認 ➔ 最新は INV-1004
14:00:00.300 [処理A] INV-1005 を書き込み完了!
14:00:00.350 [処理A] 用が済んだので「鍵を解除(releaseLock)」する!
│
14:00:00.360 [処理B] ドアが開いたので、鍵をかけて部屋に入る!
14:00:00.400 [処理B] シートを確認 ➔ 最新は【INV-1005】になっている!
14:00:00.450 [処理B] 1005 + 1 =「INV-1006」を安全に書き込み!
14:00:00.500 [処理B] 鍵を解除する。
│
▼
【大成功!】
Aさん ➔ INV-1005 が発番!
Bさん ➔ 重複することなく綺麗な連番で INV-1006 が発番!
これが、プログラミングの世界で「排他制御(Mutual Exclusion / Lock)」と呼ばれる技術です。何百人が同時にボタンを押そうとも、番号を数えてシートに書き込む決定的な瞬間だけは「1人ずつ厳格に並ばせる」ことで、二重採番を100%物理的に不可能にできるのです!
知っておくべき「3種類のロックサービス」比較
第93回のスクリプトプロパティや、第98回のキャッシュサービスと同様に、LockServiceにも用途に合わせて3つの異なるロックが用意されています。違いを表で確認しておきましょう。
| ロックの種類 | 取得メソッド | ロックの適用範囲 | 主な用途・使い分け |
|---|---|---|---|
| スクリプトロック (★今回メイン!) | LockService.getScriptLock() | そのプロジェクトを実行する全員 | 請求書番号の採番、在庫の引き落とし、予約枠の確保など、誰であっても順番に並ばせたい処理全般 |
| ユーザーロック | LockService.getUserLock() | 実行しているユーザー個人のみ | 同一ユーザーがブラウザでボタンを連打したときの二重送信防止(他のユーザーの邪魔はしない) |
| ドキュメントロック | LockService.getDocumentLock() | そのファイル単体のみ (バインドスクリプト専用) | 特定のスプレッドシートやドキュメントを直接編集する際の競合防止 |
「請求書番号の重複」や「社用車・会議室の二重予約」を防ぎたいときは、ユーザーに関係なくシステム全体で1つの鍵を取り合う必要があるため、迷わず LockService.getScriptLock() 一択となります!
2. LockService の主要メソッド一覧と動くルール
LockServiceを使いこなすために覚えるべき命令は、実は片手で数えられるほどしかありません。それぞれのメソッドの役割と構文を押さえておきましょう。
① 鍵オブジェクトを取得する:getScriptLock()
var lock = LockService.getScriptLock();
まず最初に、排他制御の司令塔である「Lockオブジェクト」を呼び出します。
※注意:このコードを書いた時点では、まだ「鍵を手にしただけ」であり、鍵はかかっていません!
② 鍵がかかるまで待つ:waitLock(timeoutInMilliseconds)【一番推奨!】
// 最大10秒間(10000ミリ秒)、鍵が空くまで順番待ちをする
lock.waitLock(10000);
実務で99%使われるのがこの waitLock() です。
もし別のユーザーが鍵を使っていた場合、指定したミリ秒数(例: 10000ms = 10秒)の間、ドアの前でじっと待機します。前の人の処理が終わって鍵が開いた瞬間、自動的に鍵を奪って自分の処理をスタートします。
※もし指定した時間(10秒)ずっと待っても前の人の処理が終わらなかった場合は、例外エラー(Could not obtain lock)を投げて停止します。
③ 待たずにすぐ諦める:tryLock(timeoutInMilliseconds)
var success = lock.tryLock(5000);
if (!success) {
Logger.log("現在他のユーザーが処理中です。時間をおいて再試行してください。");
return;
}
指定した時間だけ鍵の獲得を試み、成功したかどうかを true または false で返します。「他の人が使っていたら、待たずにすぐ『混雑中です』と画面にエラーを出したい」という場面で使います。
④ 鍵を返却する:releaseLock()【超重要】
lock.releaseLock();
用が済んだら、次の人のために必ず鍵を開けて返却します。これを忘れると、後ろに並んでいるすべてのユーザーがドアの外で締め出されてしまう大事故(デッドロック)になります!
3. STEP1:準備!「請求書番号管理シート」を用意しよう
理論がバッチリ頭に入ったところで、手元で動かせるハンズオン環境を作っていきましょう!
今回は、札幌オフィスの経理システムを想定し、請求データが蓄積されるスプレッドシートを準備します。
スプレッドシートの作成手順:
1. Googleドライブを開き、新しいGoogleスプレッドシートを作成します。
2. ファイル名を「札幌オフィス_請求採番管理システム」に変更します。
3. シートタブの名前を「請求台帳」に変更します。
4. 1行目に見出し、2行目〜4行目に初期の請求データを入力してください。
| A列(請求管理番号) | B列(取引先名) | C列(案件名) | D列(請求金額) | E列(発行日時) | F列(発行担当者) |
|---|---|---|---|---|---|
| INV-1001 | 株式会社札幌スープカレー本舗 | ECサイト改修・決済連携 | 165,000 | 2026/11/01 10:00:00 | 道産子 太郎 |
| INV-1002 | 道産子フーズ株式会社 | GAS業務自動化ツール導入 | 220,000 | 2026/11/02 11:30:00 | 大通 花子 |
| INV-1003 | 北海ITソリューションズ | クラウドサーバー保守(11月) | 55,000 | 2026/11/02 15:45:00 | 道産子 太郎 |
A列の管理番号を見てみると、「INV-1001」「INV-1002」「INV-1003」と綺麗に並んでいますね。
次に発行されるべき正しい番号は、当然「INV-1004」です。この番号を、GASプログラムで安全に自動採番するロジックを作っていきます。
シートの準備ができたら、上部メニューバーの「拡張機能」>「Apps Script」をクリックしてエディタを開いておきましょう!
4. STEP2:【実験】ロックなしだとどうなる?二重採番を擬似再現してみよう
まずは、「なぜロックが必要なのか」を骨の髄まで実感していただくために、あえて「排他制御(ロック)をかけない無防備なコード」を実行して、二重採番が起きる状態をシミュレーションしてみましょう!
1. エディタ内のコードをすべて消去し、以下のスクリプトを貼り付けます。
/**
* 第99回 STEP2:【危険】ロックをかけない無防備な採番処理
* 意図的に途中にウェイト(第97回 sleep)を挟むことで、同時アクセス時の重複を再現します。
*/
function issueInvoiceWithoutLock(companyName, projectName, amount, staffName) {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("請求台帳");
// 1. スプレッドシートから現在のデータを取得
var lastRow = sheet.getLastRow();
var idList = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
// 2. 現在の最大番号を計算する
var maxNum = 1000;
for (var i = 0; i < idList.length; i++) {
var match = String(idList[i][0]).match(/INV-(\d+)/);
if (match) {
var num = parseInt(match[1], 10);
if (num > maxNum) maxNum = num;
}
}
// 3. 次の新しい番号を決定する
var nextNum = maxNum + 1;
var newInvoiceId = "INV-" + nextNum;
Logger.log("【" + staffName + "】が " + newInvoiceId + " を採番しました。(これから書き込みます)");
// -------------------------------------------------------------
// ★実験用:第97回で学んだ sleep で「サーバーの処理遅延(2秒)」を再現!
// この2秒の間に別の人がアクセスしてくると大事故が起きる
// -------------------------------------------------------------
Utilities.sleep(2000);
// 4. スプレッドシートの末尾に書き込む(第7回 appendRow)
var now = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
sheet.appendRow([newInvoiceId, companyName, projectName, amount, now, staffName]);
Logger.log("✅ 【" + staffName + "】の請求書「" + newInvoiceId + "」がシートに書き込まれました!");
}
// 疑似的に「ほぼ同時(0.5秒差)」でボタンが押された状態を再現するテスト関数
function simulateSimultaneousClicks() {
Logger.log("=== 同時クリック実験スタート ===");
// 1人目:佐藤さんがクリック
issueInvoiceWithoutLock("時計台前不動産", "店舗サイネージ保守", 88000, "佐藤");
// ※実際のWeb環境では、別スレッドでほぼ同時に2人目が割り込んできます
}
上記のコードを見てみてください。
スプレッドシートの最大番号を読み取ってから、実際に appendRow() でシートに書き込むまでの間に、わずかな処理時間(今回は Utilities.sleep(2000))が存在していますよね。
もしWebアプリの画面から、2人のユーザーが0.5秒差でボタンをクリックした場合、2人目の処理は「1人目が書き込む前の古い最大値(INV-1003)」を読み取ってしまうため、両方とも「INV-1004」を生成して書き込んでしまいます。
これが、現場で「たまに請求番号が重複して大パニックになる」という怪現象の正体です!
5. STEP3:【実践】LockService.getScriptLock() で排他制御を組み込もう!
それでは、いよいよ本日のメインディッシュです!
先ほどの危険なコードに LockService.getScriptLock() を組み込み、どれだけ大勢が同時にボタンを連打しても、絶対に1人ずつ綺麗に連番で採番される鉄壁のスクリプトへと進化させましょう!
プロの鉄則構文:try...finally との組み合わせ
コードを書く前に、世界中のGASエンジニアが100%徹底している「ロック処理の絶対ルール」を確認します。
// 【プロの鉄則構文】
var lock = LockService.getScriptLock();
lock.waitLock(10000); // ① まず鍵をかける
try {
// ② ここに保護したい大切な処理(採番・書き込み)を書く!
} finally {
// ③ 何があっても「絶対に最後に鍵を解除する!」
lock.releaseLock();
}
第30回で学んだ try...catch...finally を覚えていますでしょうか?finally ブロックの中に書かれた処理は、「プログラムが正常に終わった時」はもちろん、「途中で重大なエラーが発生して落ちた時」でも、100%絶対に最後に実行されるという特別な性質を持っています。
もし finally を書かずに、処理の途中でエラーが起きてプログラムが止まってしまったらどうなるでしょうか?
鍵がかかったまま放置され、以後すべてのユーザーが二度とシステムを使えなくなる「永久デッドロック」が発生してしまいます。だからこそ、「ロックを使ったら、解除は必ず finally に書く!」が絶対のお約束なのです。
鉄壁の排他制御コードを入力しよう!
エディタのコードを、以下の完全版スクリプトに書き換えて保存してください。
/**
* 第99回 STEP3:LockService による鉄壁の請求書自動採番処理
* 同時に何人がボタンを押しても、絶対に番号の重複を起こさせません。
*/
function issueInvoiceWithLock(companyName, projectName, amount, staffName) {
// ① スクリプト全体のロック(鍵)を取得する
var lock = LockService.getScriptLock();
// ② 最大10秒間、前の人の処理が終わるのを待機する!
// ※10秒以内に鍵が取れなければ例外エラーを出して安全に停止
lock.waitLock(10000);
try {
Logger.log("🔒 【" + staffName + "】がロック(鍵)を獲得しました!安全ゾーンに入ります。");
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("請求台帳");
// 1. 最新のスプレッドシートデータを安全に取得
var lastRow = sheet.getLastRow();
var idList = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
// 2. 現在の最大番号を計算
var maxNum = 1000;
for (var i = 0; i < idList.length; i++) {
var match = String(idList[i][0]).match(/INV-(\d+)/);
if (match) {
var num = parseInt(match[1], 10);
if (num > maxNum) maxNum = num;
}
}
// 3. 次の新しい番号を確実に生成!
var nextNum = maxNum + 1;
var newInvoiceId = "INV-" + nextNum;
Logger.log("📝 【" + staffName + "】の請求番号を「" + newInvoiceId + "」に決定しました。");
// 4. スプレッドシートの末尾に書き込む(第7回 appendRow)
var now = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
sheet.appendRow([newInvoiceId, companyName, projectName, amount, now, staffName]);
// スプレッドシートへの反映を強制確定させる(第60回でも登場したプロの技!)
SpreadsheetApp.flush();
Logger.log("✅ 【" + staffName + "】の請求書「" + newInvoiceId + "」をシートへ安全に記録完了!");
return {
success: true,
invoiceId: newInvoiceId,
company: companyName
};
} catch (error) {
Logger.log("⚠️ 処理中にエラーが発生しました: " + error.message);
throw error; // エラーを上位(フロントエンド)へ投げる
} finally {
// -------------------------------------------------------------
// ⑤ 【最重要】何があっても絶対に鍵を返却する!
// これにより、待機していた次の人が即座に入室できるようになる
// -------------------------------------------------------------
lock.releaseLock();
Logger.log("🔓 【" + staffName + "】がロック(鍵)を返却しました。次の人どうぞ!");
}
}
// 動作検証用:テスト実行関数
function testSafeInvoiceIssue() {
Logger.log("=== 安全採番テストを開始します ===");
// 1件目を発行してみる
var res1 = issueInvoiceWithLock("札幌時計台前不動産", "店舗サイネージ保守", 88000, "道産子 太郎");
Logger.log("結果1: " + JSON.stringify(res1));
// 連続して2件目を発行してみる
var res2 = issueInvoiceWithLock("定山渓リゾートホテル", "館内Wi-Fiリニューアル", 450000, "大通 花子");
Logger.log("結果2: " + JSON.stringify(res2));
Logger.log("=== 安全採番テスト完了 ===");
}
コードの解説:現場が唸る3つのプロ技!
1. lock.waitLock(10000) の安全設計:
もし先客がいても、10秒間は静かにドアの前で順番待ちをします。10秒あれば、スプレッドシートの1行書き込み(通常0.2〜0.5秒)なら十数人が並んでいても余裕で自分の番が回ってきます。
2. SpreadsheetApp.flush() の強制同期:
第97回でも触れましたが、GASはスプレッドシートの書き込みをメモリ上に溜め込み、スクリプトが全部終わってからまとめて反映しようとする癖があります。次の人が入室してきたときに確実に最新の行が書き込まれている状態にするため、SpreadsheetApp.flush() を呼んで「今すぐシートの実体に書き込んで確定させて!」と強制命令を出しています。
3. finally での確実な releaseLock():
データの書き込みが終わった瞬間に lock.releaseLock() が呼ばれ、待っていた次の人が0.01秒で入室して新しい番号を計算します。
実行して結果を確認しよう!
エディタで testSafeInvoiceIssue を選択し、「実行」ボタンを押してみましょう!
(※初回はアクセス承認画面が出ますので、画面の指示に従って許可してください)。
情報 === 安全採番テストを開始します ===
情報 🔒 【道産子 太郎】がロック(鍵)を獲得しました!安全ゾーンに入ります。
情報 📝 【道産子 太郎】の請求番号を「INV-1004」に決定しました。
情報 ✅ 【道産子 太郎】の請求書「INV-1004」をシートへ安全に記録完了!
情報 🔓 【道産子 太郎】がロック(鍵)を返却しました。次の人どうぞ!
情報 結果1: {"success":true,"invoiceId":"INV-1004","company":"札幌時計台前不動産"}
情報 🔒 【大通 花子】がロック(鍵)を獲得しました!安全ゾーンに入ります。
情報 📝 【大通 花子】の請求番号を「INV-1005」に決定しました。
情報 ✅ 【大通 花子】の請求書「INV-1005」をシートへ安全に記録完了!
情報 🔓 【大通 花子】がロック(鍵)を返却しました。次の人どうぞ!
情報 結果2: {"success":true,"invoiceId":"INV-1005","company":"定山渓リゾートホテル"}
情報 === 安全採番テスト完了 ===
スプレッドシートを開いてみてください!
A列に「INV-1004」、そして次の行に「INV-1005」と、寸分の狂いもなく美しい連番でデータが追加されているはずです!
6. STEP4:【実務応用】Webダッシュボードと連携!UI側のタイムアウト対策
バックエンドのロック処理が完成したら、フェーズ9で学んだWebアプリ(フロントエンド)と繋ぎ込みましょう!
Web画面から利用者がボタンを押したとき、もし他の人が大勢並んでいて10秒の待ち時間を超えてしまった場合でも、画面がフリーズせずに「現在アクセスが集中しています。恐れ入りますが数十秒後に再度お試しください」と親切なメッセージを返すUI設計を実装します。
1. バックエンド(コード.gs)にWeb受信用関数を追加
コード.gs に、Webアプリ表示用の doGet(e) と、フロントエンドから google.script.run で呼ばれるAPI関数を用意します。
function doGet(e) {
var html = HtmlService.createTemplateFromFile('index').evaluate();
html.setTitle('【札幌オフィス】請求書発行ポータル');
html.addMetaTag('viewport', 'width=device-width, initial-scale=1');
return html;
}
/**
* Web画面から google.script.run で呼び出される請求書発行関数
*/
function apiIssueInvoice(formData) {
var lock = LockService.getScriptLock();
// 最大8秒間待機を試みる(tryLock)
var hasLock = lock.tryLock(8000);
// 8秒待っても鍵が取れなかった場合(大混雑時)
if (!hasLock) {
return {
success: false,
message: "⚠️ 現在、他のスタッフが請求書を発行中です。データ保護のため、数十秒ほど待ってからもう一度お試しください。"
};
}
try {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("請求台帳");
var lastRow = sheet.getLastRow();
var idList = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
var maxNum = 1000;
for (var i = 0; i < idList.length; i++) {
var match = String(idList[i][0]).match(/INV-(\d+)/);
if (match) {
var num = parseInt(match[1], 10);
if (num > maxNum) maxNum = num;
}
}
var newInvoiceId = "INV-" + (maxNum + 1);
var now = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
// シートに保存
sheet.appendRow([
newInvoiceId,
formData.company,
formData.project,
Number(formData.amount) || 0,
now,
formData.staff
]);
SpreadsheetApp.flush(); // 強制確定
return {
success: true,
invoiceId: newInvoiceId,
message: "🎉 請求番号「" + newInvoiceId + "」で正常に発行・登録されました!"
};
} catch (err) {
return {
success: false,
message: "システムエラーが発生しました: " + err.message
};
} finally {
lock.releaseLock(); // 確実に鍵を開ける
}
}
2. フロントエンド(index.html)の実装
エディタの左側「+」>「HTML」で index.html を作成し、以下のコードを貼り付けます。
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<base target="_top">
<title>札幌オフィス 請求書発行</title>
<style>
* { box-sizing: border-box; margin: 0; padding: 0; }
body { font-family: "Helvetica Neue", Arial, sans-serif; background: #f0f4f8; padding: 30px; display: flex; justify-content: center; }
.card { background: white; max-width: 480px; width: 100%; padding: 28px; border-radius: 12px; box-shadow: 0 4px 14px rgba(0,0,0,0.08); border-top: 5px solid #1a365d; }
h2 { font-size: 18px; color: #1a365d; margin-bottom: 8px; }
.desc { font-size: 12px; color: #718096; margin-bottom: 20px; line-height: 1.5; }
.form-group { margin-bottom: 14px; }
label { display: block; font-size: 13px; font-weight: bold; margin-bottom: 4px; color: #2d3748; }
input { width: 100%; padding: 10px; border: 1px solid #cbd5e0; border-radius: 6px; font-size: 14px; }
.btn { width: 100%; padding: 12px; background: #dd6b20; color: white; border: none; border-radius: 6px; font-size: 15px; font-weight: bold; cursor: pointer; transition: 0.2s; margin-top: 8px; }
.btn:hover:not(:disabled) { background: #c05621; }
.btn:disabled { background: #a0aec0; cursor: not-allowed; }
.banner { margin-top: 16px; padding: 12px; border-radius: 6px; font-size: 13px; display: none; line-height: 1.5; }
.banner-success { background: #c6f6d5; color: #22543d; border: 1px solid #9ae6b4; }
.banner-warning { background: #feebc8; color: #7b341e; border: 1px solid #fbd38d; }
</style>
</head>
<body>
<div class="card">
<h2>📑 請求書発行・自動採番ポータル</h2>
<p class="desc">排他制御(LockService)により、同時アクセス時も番号の二重発行を完全に防止します。</p>
<div class="form-group">
<label>取引先会社名:</label>
<input type="text" id="companyInput" placeholder="例:株式会社サッポロクリエイティブ">
</div>
<div class="form-group">
<label>案件名:</label>
<input type="text" id="projectInput" placeholder="例:冬期プロモーションLP制作">
</div>
<div class="form-group">
<label>請求金額(税込):</label>
<input type="number" id="amountInput" placeholder="例:330000">
</div>
<div class="form-group">
<label>発行担当者名:</label>
<input type="text" id="staffInput" value="札幌 太郎">
</div>
<button id="submitBtn" class="btn" onclick="onSubmitInvoice()">⚡ 請求番号を発番して発行する</button>
<div id="msgBanner" class="banner"></div>
</div>
<script>
function onSubmitInvoice() {
var btn = document.getElementById("submitBtn");
var banner = document.getElementById("msgBanner");
var company = document.getElementById("companyInput").value.trim();
var project = document.getElementById("projectInput").value.trim();
var amount = document.getElementById("amountInput").value;
var staff = document.getElementById("staffInput").value.trim();
if (!company || !project) {
alert("会社名と案件名は必須です!");
return;
}
// 二重クリック防止
btn.disabled = true;
btn.innerText = "🔒 採番ロック中...お待ちください";
banner.style.display = "none";
var payload = {
company: company,
project: project,
amount: amount,
staff: staff
};
// 第87回〜第88回の知識:google.script.run で非同期呼び出し!
google.script.run
.withSuccessHandler(function(res) {
btn.disabled = false;
btn.innerText = "⚡ 請求番号を発番して発行する";
banner.style.display = "block";
if (res.success) {
banner.className = "banner banner-success";
banner.innerText = res.message;
// 入力欄をクリア
document.getElementById("companyInput").value = "";
document.getElementById("projectInput").value = "";
document.getElementById("amountInput").value = "";
} else {
banner.className = "banner banner-warning";
banner.innerText = res.message;
}
})
.withFailureHandler(function(err) {
btn.disabled = false;
btn.innerText = "⚡ 請求番号を発番して発行する";
banner.style.display = "block";
banner.className = "banner banner-warning";
banner.innerText = "通信エラー: " + err.message;
})
.apiIssueInvoice(payload);
}
</script>
</body>
</html>
エディタ右上の「デプロイ」>「デプロイをテスト」からテスト用URL(/dev)を開いてみてください。
ブラウザから「発行ボタン」を押すと、裏側でしっかり排他制御が働き、スプレッドシートの重複が完全に排除された状態で新しい請求番号が即座に発行されます!
7. 初心者が100%つまずく!LockServiceの5大トラップと完全対処法
排他制御は非常に強力ですが、使い方を少し間違えると「システム全体がうんともすんとも言わなくなる」という恐ろしい副作用を持っています。初心者が絶対に踏んではいけない「5大トラップ」を事前にチェックしておきましょう!
トラップ1:finally を書かずにエラーで落ち、永久デッドロックになる
// ✕ 超危険!絶対にやってはいけないコード
var lock = LockService.getScriptLock();
lock.waitLock(10000);
// ここで何らかのエラー(シート名の間違いなど)が発生すると…!
sheet.getRange("Z100").getValue();
lock.releaseLock(); // ➔ ここまで到達しない!鍵がかかったまま永久封鎖!
【症状】 次に誰かがボタンを押したとき、前の人の鍵が開いていないため、全員が10秒待たされてエラーで弾かれるようになります。
【完全解決策】 必ず try { ... } finally { lock.releaseLock(); } の構文を守ってください。これだけでデッドロック事故は100%防げます!
トラップ2:waitLock() に長すぎる時間(30秒以上)を指定してしまう
「確実に順番待ちさせたいから、余裕を持って lock.waitLock(60000)(1分)にしておこう!」と設定する人がいますが、これはNGです。
GASの waitLock() に指定できる最大待機時間は 30秒(30000ミリ秒)まで と厳格に決められています。30000を超える数値を渡すと引数エラーが発生します。
実務では 5秒〜10秒(5000〜10000ms) 程度を指定するのが最もバランスが良く安全です。
トラップ3:ロックの範囲が広すぎてシステム全体が激重になる
// ✕ 悪い例:関係ない処理まで全部ロックの中に入れている
lock.waitLock(10000);
try {
// 外部のお天気APIを叩く(1秒)
// Slackに長文通知を送る(2秒)
// GoogleドキュメントのPDFを生成する(5秒)
// 最後に採番してシートに書く(0.2秒)
} finally {
lock.releaseLock();
}
【解説と対策】 ロックをかけるのは、「スプレッドシートの最大番号を確認して書き込む瞬間(0.2秒間)」だけで十分です! PDF生成やメール送信などの重い処理までロックの中に詰め込んでしまうと、待機列がどんどん伸びて全員がタイムアウトしてしまいます。
「ロックする範囲は、最小限(採番とセル書き込みの瞬間だけ)に絞る!」のがプロの設計です。
トラップ4:tryLock() の戻り値を確認せずにそのまま進んでしまう
// ✕ 間違いコード
lock.tryLock(5000);
// 鍵が取れたか確認せずに書き込み処理へ進んでいる!
sheet.appendRow([...]);
tryLock() は、鍵が取れなくてもエラーを出さずに単に false を返して通り過ぎてしまいます。
必ず if (!hasLock) { return "混雑エラー"; } のように戻り値の真偽をチェックしてください。
トラップ5:二重採番を防ぎたいのに getUserLock() を使ってしまう
「ユーザーロック」は、実行したユーザー単体に対する鍵です。Aさんが作業している最中でも、Bさんは別の鍵を持っているのでスルーして入室できてしまいます。全員で共有する番号を管理する際は、必ず LockService.getScriptLock() を使ってください!
8. 今回のまとめ&次回予告
今回は、複数人からの同時アクセスによるデータの重複や二重採番を完璧に防止する LockService.getScriptLock()(排他制御) について徹底解説しました!
本日の重要ポイントおさらい:
1. 同時アクセスによる番号重複(レースコンディション)は、LockService.getScriptLock() で解決できる!
2. waitLock(10000) を使えば、前の人の処理が終わるまで最大10秒間、自動で順番待ちしてくれる!
3. デッドロック(永久封鎖)を防ぐため、ロック解除は必ず finally { lock.releaseLock(); } に書くのがプロの鉄則!
4. 書き込み直後に SpreadsheetApp.flush() を呼んで、次の人のためにシートデータを即時確定させる!
5. ロックをかける範囲は、採番とセル書き込みの「最小限の区間」だけに絞る!
どんなに便利な自動化ツールを作っても、「たまに番号が重複する」「たまにデータが壊れる」という不安が残っていては、実務で安心して使い倒すことはできませんよね。
今回の排他制御をマスターしたことで、あなたのプログラムは「何十人、何百人のチームで同時にガンガン使っても絶対に壊れない、真のエンタープライズ品質」へと到達しました!
🚀 次回予告:ついに最終回!全100回の集大成へ
第1回「Logger.log()」で黒い画面に1行のメッセージを出すところからスタートしたこの連載も……
ついに、次回(第100回)で記念すべきグランドフィナーレを迎えます!
100回連載の有終の美を飾るテーマは、
「全連携の集大成 × 全機能を組み合わせた『札幌オフィス完全自動化ダッシュボード』完成!」 です!
スプレッドシート(DB)、Gmail(自動通知)、Googleドライブ(PDF保管)、Googleドキュメント(請求書生成)、Googleスライド(業績レポート)、Googleカレンダー(設備予約)、Webアプリ画面(HTML/CSS/JS)、外部API(気象連携)、Slack通知、そして今回の排他制御とキャッシュ――。
これまであなたが積み上げてきた全99個の強力なピースを1枚のキャンバスに集結させ、札幌オフィスのすべての業務が全自動で美しく連動する究極の統合ダッシュボードシステムを組み上げます。
これまでの集大成となる圧巻の最終回、ぜひ最高のワクワクと共に見届けてくださいね!お楽しみに!
