上线第二天客服转来三条工单:两个不同用户下单,一个成功,另一个接口也返回 200,拿到的订单号却和前者一模一样。日志里两个请求的 X-Idempotency-Key 都是 8 位十六进制,完全相同。第一次遇到会往复杂处想,其实漏掉的多是个小前提。

awk -F'idem=' '{print $2}' access.log | cut -d' ' -f1 | sort | uniq -d | wc -l
SELECT idem_key, count(*) c FROM orders GROUP BY idem_key HAVING c > 1;

幂等键是 user_id 拼 sku 后取 hashCode,再转十六进制截了前 8 位,可用空间只有 2 的 32 次方。几百万请求按生日问题算,撞上的概率比想象中高。撞上以后第二个请求被当成重复提交,直接返回第一次的结果。这一点先确认清楚,后面就不用反复试。

「幂等键哈希冲突」这类改动最怕改一半,回滚脚本先准备好,再动生产。

具体做法是,把幂等键换成完整 UUID 或雪花 ID 不要截断;落库时给幂等键建唯一索引 冲突抛异常而不是静默返回旧结果;存量订单按幂等键分组查一遍 把被顶掉的请求找出来补偿;压测跑一周看是否还有两个请求共用一个键。

改完照着核一遍,同一批压测流量跑完 重复键统计为 0 两个用户各自拿到自己的订单号。

作者 9823189