直达重点

• 幂等键：为变更请求生成 idempotency_key，服务端存储键→结果/状态，重复请求直接返回
• 自然幂等：PUT/DELETE 按资源唯一标识覆盖/删除，避免“累加型”副作用
• 事务外盒：写侧提交业务数据同时写 Outbox，再由异步消费者可靠投递事件，避免重复投递

边界与细节

• 键作用域：按用户/资源/窗口期隔离（防“误合并”）
• 结果缓存：键对应的响应体需含版本/校验，防止脏读
• 重试策略：客户端幂等重试 + 服务端去重，失败需可查