幂等与去重

用途：让“重复投递”变成无害事件

为什么必须做

至少一次投递 + 重试机制意味着重复不可避免。重复来源：生产者重试（超时但实际成功）、Broker 主从切换、消费者崩溃在提交位点前、再均衡、人工重放。去重责任在消费方，中间件不提供端到端恰好一次。

方法	做法	适用
唯一约束	业务键建唯一索引，插入冲突即视为重复	新增类操作（登记、流水）
状态机守卫	条件更新 `WHERE status = 期望前态`，影响行数 0 即已处理	状态推进类（支付、发货）
去重表/缓存	处理前查 `msg_dedup(biz_key)`，处理后写入（带 TTL）	无法用唯一约束的复杂动作
版本号/时间戳	携带版本，旧版本请求被拒绝	乱序 + 重复同时存在

幂等键必须是业务键（订单号 + 操作类型 + 版本），不是消息 ID：业务重试会产生新消息 ID，而同一业务动作的键不变。

“查一下有没有处理过，再处理”在并发下不成立。正确做法：

消息到达 → 幂等检查 → 业务处理（事务）→ 记录完成 → 失败则重试/死信 → 定期对账兜底

对账负责发现“幂等逻辑漏掉的不一致”（例如消息根本没到），是最后一层。