文章目錄
- 1. 先對齊可售和保留庫存的定義
- 可售庫存不等於實體庫存
- 保留庫存要設定存活時間
- 2. 列出訂單與付款狀態
- 訂單狀態通常分成這幾種
- 付款狀態要跟金流系統對齊
- 3. 建立扣回庫存對照表
- 下單到付款完成的扣回邏輯
- 退款與回補庫存不是必然畫等號
- 4. 在測試環境重現逾期及同時下單
- 逾期釋放的測試做法
- 同時下單的併發測試
- 5. 驗證後台前台與外部系統一致
- 三方比對的具體做法
- 建立定期稽核機制
購物網站庫存同步的做法,核心是先把「可售庫存」與「保留庫存」兩個概念分開定義,再依訂單狀態建立扣庫存與回補庫存的對照表,最後在測試環境模擬逾期取消與同時下單的情境,驗證後台、前台與外部系統三方數字一致。
許多購物網站上線後才發現賣超或庫存卡住,追根究柢往往不是程式寫錯,而是一開始沒有把這些狀態定義清楚。常見情況是,行銷活動一上線,同一款商品在十分鐘內湧入上百張訂單,後台顯示還有庫存,前台卻顯示缺貨,或者反過來,賣到負庫存還渾然不知。這類問題不是靠加強主機效能就能解決,而是要從狀態設計開始重新梳理。
本文重點摘要
- 購物網站庫存同步的第一步,是明確區分可售庫存與保留庫存,而不是急著改程式碼
- 訂單狀態與付款狀態若混用同一個欄位判斷,是庫存不同步最常見的根本原因
- 扣庫存對照表至少要涵蓋下單、付款成功、逾期取消、退款四種狀態組合
- 超賣問題多半發生在同時下單的瞬間,必須在測試環境模擬併發才看得到
- 後台、前台與金流/物流外部系統三方數字對不上,才是驗收庫存同步是否成功的真正標準
先對齊可售和保留庫存的定義

庫存不同步的根源,常常不是技術問題,而是「大家對同一個數字有不同理解」。業務人員認為庫存是「倉庫裡實際有多少貨」,工程師認為庫存是「資料庫欄位的數字」,但這兩者在購物網站的情境下其實不夠用,還需要加入第三種概念:保留庫存。
可售庫存不等於實體庫存
可售庫存(Available Stock)指的是「目前可以被顧客下單購買」的數量,而實體庫存是倉庫中真正存在的貨品數量。兩者之間的差額,就是被「保留」住、暫時不能再賣給別人的部分。假設一件商品倉庫實際有 50 件,其中 8 件正被其他顧客的訂單佔用(已下單但尚未付款),可售庫存就應該顯示為 42 件,而不是 50 件。如果系統只用單一欄位記錄庫存,沒有拆分可售與保留,就很容易在高流量時段出現同一件商品被兩個顧客同時「買到」的情況。
保留庫存要設定存活時間
保留庫存不能無限期存在,否則顧客把商品加入購物車卻不結帳,會永久卡住庫存,讓其他真正想買的人買不到。實務上需要替每一筆保留庫存設定一個存活時間(Time To Live,簡稱 TTL),常見做法是訂單建立後保留 15 到 30 分鐘,時間一到若還沒完成付款,系統就自動把保留庫存釋回可售庫存。這個時間長短該怎麼抓,需要依照商品特性與結帳流程複雜度評估,沒有單一正確答案,但一旦訂下規則,就必須在訂單狀態機裡確實執行,不能只是寫在規格文件裡卻沒有程式邏輯對應。
庫存同步的第一個決策點,不是選哪套系統,而是先畫出「可售」與「保留」兩條線在哪裡。
延伸閱讀:購物網站建置步驟教學:從零開始的 8 大實作流程列出訂單與付款狀態

訂單狀態與付款狀態是兩條不同的軌道,很多購物網站開發時圖方便,把這兩種狀態塞進同一個欄位管理,結果就是邏輯越改越複雜,後續要新增「部分退款」或「超商取貨逾期」這類狀態時,整個判斷式牽一髮動全身。
訂單狀態通常分成這幾種
常見的訂單狀態包含:待處理(剛建立,等待付款)、已確認(付款完成,等待出貨)、已出貨、已完成、已取消、退貨中、已退款。這些狀態描述的是「訂單這張單子目前走到哪個階段」,跟錢有沒有進帳是分開的概念。
付款狀態要跟金流系統對齊
付款狀態則包含:未付款、付款處理中(等待金流商回呼)、付款成功、付款失敗、已退款、部分退款。這一塊通常跟金流服務商的 Webhook 或回呼機制綁在一起,例如信用卡授權成功後,金流商會透過非同步的方式通知購物網站後端,這中間存在時間差,如果網站端沒有正確處理回呼,就會出現顧客已經扣款、但訂單系統還停留在「未付款」狀態的落差,這也是庫存卡在保留狀態遲遲沒有轉正的常見原因之一。
| 狀態類型 | 狀態值 | 代表意義 | 是否影響庫存 |
|---|---|---|---|
| 訂單狀態 | 待處理 | 訂單建立,尚未完成付款 | 進入保留庫存 |
| 訂單狀態 | 已取消 | 顧客主動取消或系統逾期取消 | 保留庫存釋回可售 |
| 付款狀態 | 付款處理中 | 等待金流商回呼確認 | 維持保留庫存 |
| 付款狀態 | 付款成功 | 金流確認扣款完成 | 保留庫存轉為正式扣除 |
把這兩條狀態軌道拆開後,才能清楚定義「庫存變動應該綁在哪個狀態的哪個轉換點上」,這也是下一節扣回庫存對照表能夠成立的前提。
建立扣回庫存對照表

有了可售/保留庫存的定義,也拆開訂單與付款兩條狀態軌道後,接下來要做的是把每一種狀態組合,對應到一個明確的庫存動作:扣庫存、保留庫存、釋回庫存,或是維持不變。這張表就是整個庫存同步邏輯的核心,也是工程團隊開發與測試時最重要的參考依據。
下單到付款完成的扣回邏輯
以下範例為假設情境,說明一種常見的狀態與庫存動作對應方式,實際規則仍須依照各家購物網站的金流與物流流程調整,並與開發團隊確認程式實作方式是否與表格一致。
| 情境 | 訂單狀態 | 付款狀態 | 庫存動作 |
|---|---|---|---|
| 顧客送出訂單 | 待處理 | 未付款 | 從可售庫存轉入保留庫存 |
| 金流確認付款成功 | 已確認 | 付款成功 | 保留庫存正式轉為已扣除(出貨用) |
| 超過保留時限未付款 | 已取消(逾期) | 未付款 | 保留庫存釋回可售庫存 |
| 顧客申請退貨退款 | 退貨中→已退款 | 已退款 | 已扣除庫存視情況回補可售庫存 |
退款與回補庫存不是必然畫等號
這裡有個常被忽略的細節:退款不代表商品一定要回補到可售庫存。假設顧客收到的商品已經拆封或有瑕疵,退回來的實體商品可能無法再銷售,這時候退款動作應該觸發「庫存調整」流程,而不是自動把庫存加回可售數量。這個判斷涉及商品檢驗、倉儲管理等後續流程,不屬於单純的狀態機邏輯,需要額外的人工確認步驟或商品狀態標記,不能把扣回庫存想像成單純的加減法。
庫存同步的難點從來不是扣庫存,而是退款後該不該加回去。
在測試環境重現逾期及同時下單

對照表畫得再完整,沒有實際測試過也只是紙上談兵。庫存不同步最容易出問題的兩種情境,一是訂單逾期未付款的釋放機制,二是多人同時下單搶購同一件商品的併發情況,這兩種都必須在測試環境中刻意模擬出來,而不是等上線後被顧客客訴才發現。
逾期釋放的測試做法
測試逾期釋放機制時,常見做法是把保留時限暫時調短(例如測試環境設定為 1 分鐘),建立一筆訂單後不付款,觀察系統是否在時限到期後,自動把保留庫存釋回可售庫存,並確認訂單狀態是否正確轉為「已取消」。這個測試務必在測試環境或預備環境執行,避免影響正式營運中的真實庫存與顧客訂單。
測試時也要注意背景排程(例如 Cron Job 或排程服務)的執行頻率,如果排程是每 10 分鐘跑一次,即使保留時限設定為 1 分鐘,實際釋放也可能延遲到下一次排程才執行,這種延遲是否符合業務需求,需要事前評估。
同時下單的併發測試
同時下單造成的超賣問題,通常只在高流量時段才會顯現,平常手動測試一個人慢慢下單是看不出來的。假設情境:某商品可售庫存只剩 1 件,若兩名顧客幾乎同一秒按下結帳,系統若沒有正確的鎖定機制(例如資料庫層級的悲觀鎖或樂觀鎖),就可能讓兩筆訂單都扣庫存成功,最後變成庫存顯示 -1 件。要重現這個情境,可以使用壓力測試工具模擬多個請求在極短時間內同時送出同一商品的下單請求,觀察系統最終庫存是否保持在合理範圍,而不是出現負數。
併發測試務必在獨立的測試環境執行,不要在正式站測試同時下單,這會直接影響真實顧客的訂單與庫存數字。
測試工具的選擇需依照開發團隊熟悉的技術堆疊決定,常見作法是透過程式撰寫簡單的腳本,在短時間內發送多筆模擬請求,相關測試方法可參考 MDN Web Docs 關於非同步請求的說明,理解請求併發送出時可能產生的時間差與競爭情況。
驗證後台前台與外部系統一致

庫存同步的最後一哩路,是確認後台管理介面、前台顧客看到的庫存顯示,以及金流、物流等外部系統三方的數字彼此一致。如果這三方有任何一方數字對不上,代表同步機制還有漏洞,不能視為驗收完成。
三方比對的具體做法
驗證時建議採取逐筆比對的方式:在後台查詢某商品的可售庫存數字,同時打開前台商品頁確認顯示的庫存或缺貨狀態,再登入金流或物流系統後台,確認該商品相關訂單的出貨與付款紀錄是否與前兩者吻合。如果購物網站有串接外部的進銷存系統或 ERP,也要把這套系統納入比對範圍,因為庫存不同步經常發生在「購物網站自己的資料庫」與「外部系統」之間的資料傳輸延遲或格式錯誤。
建立定期稽核機制
一次性的驗證只能證明「當下」是對的,不能保證往後持續正確,因此建議建立定期稽核機制,例如每日或每週排程自動比對各系統的庫存數字,若發現差異超過預先設定的門檻,就自動發出警示通知相關人員處理。這種機制的設計原則與網站監控、異常告警的概念類似,重點不在於多複雜的工具,而在於有沒有「持續在看」這件事,相關的資料一致性議題,也可以參考 Wikipedia(英文版)關於最終一致性(Eventual Consistency)的說明理解分散式系統中資料同步延遲的本質限制。
庫存同步沒有一勞永逸,只有持續稽核才看得出破口在哪。
延伸閱讀:購物網站重複下單怎麼查:按鈕連點與訂單識別排查 延伸閱讀:網站改版換網址:301 對照表與舊連結驗收全攻略庫存同步的狀態設計沒有標準答案,每個購物網站的商品特性、金流商、物流商都不一樣,上述對照表只是起點,實際導入時仍須與開發團隊逐項確認邏輯是否符合自家營運流程。如果貴公司正在規劃購物網站建置或既有系統的庫存邏輯健檢,歡迎與我們討論需求範圍與測試規劃,我們提供客製化網站開發與系統維護顧問服務,協助釐清從下單到出貨的每一個狀態節點。
庫存邏輯卡關,找人一起拆解
如果貴公司的購物網站也遇到庫存不同步、訂單狀態混亂的狀況,歡迎與我們聯繫,討論現況盤點與測試規劃的可行方向。