本更新日志汇总了与库存和退款变更的并发保护功能相关的所有更新。
比较并交换（Compare and Swap）变更
为防止库存更新中的竞态条件，我们通过在多个API版本中引入changeFromQuantity字段来提供比较并交换保护。
- 2026-01 ： 引入对 changeFromQuantity 字段的变更，适用于各种库存变更操作
- 2026-01： 引入对 changeFromQuantity 字段的变更，适用于库存 Set Quantities 变更操作，并弃用旧版比较并交换字段 inventorySetQuantities ，并弃用旧版比较并交换字段
- 2026-04： 使 changeFromQuantity 字段成为必填项（支持显式选择退出），适用于各种库存变更操作（破坏性更新） (BREAKING)
- 2026-04： 使 changeFromQuantity 字段成为必填项（支持显式选择退出），适用于库存 Set Quantities 变更操作，并移除旧版比较并交换字段（破坏性更新） inventorySetQuantities ，并移除旧版比较并交换字段 (BREAKING)
幂等性变更
为防止在请求重试时出现重复操作，我们通过 `idempotent` 指令引入幂等保护：
- 2026-01: 为各种库存和退款变更引入可选的 idempotent `idempotent` 指令
- 2026-04 为各种库存和退款变更操作强制要求使用idempotent指令 (BREAKING)。
做出这些变更的原因
大多数库存调整缺乏并发控制和幂等保护，导致系统容易受到竞态条件、重复更新和数据完整性问题的影响——尤其是在因网络中断而重试命令时。为解决这一问题，我们将标准化 Inventory API 中的并发控制和幂等检查。
更多信息，请参阅我们的 幂等性 和 比较并交换 文档。