後端、資料與安全 深入了解 A1 · 正式標準 平台: 網頁

Idempotency

冪等性

冪等性是指同一個預期操作重複執行,伺服器端的結果仍和執行一次相同。每次回應不一定要完全一樣。

看看怎麼運作
也有人這樣說 Idempotency重試安全冪等操作

看看怎麼運作

原創情境範例冪等性

另一個例子

付款逾時後,買家用冪等鍵 `8f2…` 和相同的正規化請求雜湊重試。伺服器會回傳第一次的交易,不會再扣一次款。同一個鍵若改用不同金額會被拒絕,而且這些鍵會依文件中的規則到期。

主要部分

  1. 01操作識別
  2. 02重複偵測
  3. 03穩定效果與保存結果

什麼時候用

不可靠的網路、訊息佇列、付款呼叫,以及可能至少投遞一次訊息的系統,都需要設計成可安全重試。

什麼時候不要用

`POST` 不一定都不是冪等操作。冪等鍵也不能取代資料庫交易、授權或衝突檢查。

程式裡的名稱

HTTP method semantics and/or scoped idempotency key with request fingerprint

上線前要檢查

檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。

可以直接複製的需求

預期成果:為這套系統設計或檢查 冪等性 (Idempotency),並讓資料保持正確、安全且容易維護。 使用者情境:付款逾時後,買家用冪等鍵 `8f2…` 和相同的正規化請求雜湊重試。伺服器會回傳第一次的交易,不會再扣一次款。同一個鍵若改用不同金額會被拒絕,而且這些鍵會依文件中的規則到期。 技術概念或控制措施:冪等性 (Idempotency)。 適用理由:不可靠的網路、訊息佇列、付款呼叫,以及可能至少投遞一次訊息的系統,都需要設計成可安全重試。 不應使用的情況:`POST` 不一定都不是冪等操作。冪等鍵也不能取代資料庫交易、授權或衝突檢查。 工程要求:定義輸入、輸出、介面約定,以及任何情況都不能破壞的規則。說明授權與輸入檢查範圍。定義失敗、逾時、重試和重複執行只生效一次的規則。也要定義資料搬移與相容限制。 營運要求:加入監控訊號與隱藏敏感資料的記錄。設定容量上限並寫好操作手冊。測試復原與回復上一版的流程。 驗收條件:介面約定與失敗路徑測試通過。重試或部分失敗時,資料與授權規則仍正確。效能上限、監控、復原與回復上一版的方法都已驗證。 證據與限制(證據邊界):標準只涵蓋列出的範圍,不會替你決定外觀、產品做法或 Vibulary 的教學範例。 待確認:程式執行環境、資料位置、流量形態、資料一致需求和安全邊界。也要確認相容期間、服務目標(SLO)與回復上一版的限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 冪等性 (Idempotency)。 定義:冪等性是指同一個預期操作重複執行,伺服器端的結果仍和執行一次相同。每次回應不一定要完全一樣。 正式環境檢查:檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

A1
這個術語有多正式?

正式標準

本頁說明的規則,可在列出的正式標準中找到。

標準只涵蓋列出的範圍,不會替你決定外觀、產品做法或 Vibulary 的教學範例。

適用範圍
只包含來源有說明的內容:正式名稱、定義、語意、實作
文件狀態
標準軌文件
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · IETF · 標準軌文件 HTTP Semantics — 9.2.2 Idempotent Methods 9.2.2 Idempotent Methods 適用範圍: 正式名稱、定義、語意、實作 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 語意, 實作 正式來源 · IETF · 標準軌文件 HTTP Semantics 適用範圍: 正式名稱、定義、語意、實作 本頁用途: 只支援寫明的範圍 來源涵蓋內容: 正式名稱, 定義, 語意, 實作

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。