本頁只練什麼
能把去重查詢與 append 放在同一把 lock 內，重試沿用 submissionId。
timeout 代表結果未知，重試若換 id 會建立重複訂單。
要修改的檔案：files/starter/apps-script/Code.gs
定位：先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。｜依 starter-3 定位，只修改「LockService 與 submissionId 去重」的責任。
LESSON-27 · TOPIC 03
LockService 與 submissionId 去重
能把去重查詢與 append 放在同一把 lock 內，重試沿用 submissionId。
任務情境
先結果，再原理；完成後要能說出自己看見的證據。
現在的問題
學生正在累積 project/e-commerce，必須在不碰外部服務的前提下完成「LockService 與 submissionId 去重」。
起始狀態：本地 fixture 已準備 LockService 與 submissionId 去重 的最小資料，尚未執行驗收。
完成後要看到
三筆輸入去重為兩筆，remoteRequests=0。
驗收證據：operation=dedupe、inputCount=3、outputCount=2、remoteRequests=0
何時會用到
第 23–28 章運動器材電商在修改 apps-script/Code.gs 時。
常見混淆：看到畫面不等於契約通過；仍要核對欄位、操作與證據。
觀念與最小範例
這段程式是理解起點，不是要你直接跳過 Starter。
LockService 與 submissionId 去重 Lock and idempotency
能把去重查詢與 append 放在同一把 lock 內，重試沿用 submissionId。
正式說法：Lock and idempotency 是把 LockService 與 submissionId 去重 的輸入、責任、輸出與證據固定成可重現契約。
findBySubmissionId_ before appendRow inside lock三步完成本主題
每一步都留下可觀察結果；如果沒看到，先看「卡住先查」。
Step 1｜先看見目前缺口，不急著貼答案。
檔案：
files/starter/apps-script/Code.gs定位：先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。要做：先重新載入 Starter，記錄目前畫面、DOM、Computed、Console 或文件內容。
預期：能指出「先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。」目前的缺口。
證據：保存 files/starter/apps-script/Code.gs 的目前狀態，並指出下一步只會修改哪個檔案責任。
卡住先查：確認開啟的是 files/starter/apps-script/Code.gs，且定位到 先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。。
Step 2｜只修改本主題的一個責任。
檔案：
files/starter/apps-script/Code.gs定位：先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。要做：對兩筆相同 submissionId 執行本地 dedupe，核對輸出列數。
預期：三筆輸入去重為兩筆，remoteRequests=0。
證據：operation=dedupe、inputCount=3、outputCount=2、remoteRequests=0
卡住先查：先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。
Step 3｜重新載入並以證據驗收，不以『看起來差不多』判定完成。
檔案：
files/starter/apps-script/Code.gs定位：先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。要做：重新整理頁面，再逐項比對預期結果與 evidence。
預期：三筆輸入去重為兩筆，remoteRequests=0。
證據：operation=dedupe、inputCount=3、outputCount=2、remoteRequests=0
卡住先查：先確認 findBySubmissionId_ 位於 appendRow 之前且兩者都在 lock try 區。
觀察示範
這個示範只讓你看懂概念，不會替你修改 Starter，也不會自動宣告完成。
LockService 與 submissionId 去重runtime fixture · read-only demo
本主題示範畫面：
驗收證據
勾選只是學習紀錄；真正完成仍要回到 Starter 的實際結果。
提示 1｜方向
方向提示：先只找出「LockService 與 submissionId 去重」的輸入與可觀察輸出，不同時修改別的責任。
提示 2｜關鍵片段
關鍵片段：findBySubmissionId_ before appendRow inside lock
提示 3｜完整解答與原因
完整解答與原因：對兩筆相同 submissionId 執行本地 dedupe，核對輸出列數。；驗收必須得到「operation=dedupe、inputCount=3、outputCount=2、remoteRequests=0」，因為這項證據直接對應本 module 的成功條件。