如何在 Go 中实现请求幂等性校验-Golang-PHP中文网

直接用 uuid 作幂等键不安全，因客户端可伪造且服务端未校验前次响应状态；安全幂等需绑定请求内容、业务上下文与三态（processing/succeeded/failed）状态机，并由客户端生成可追溯的唯一键。

如何在 go 中实现请求幂等性校验

为什么直接用 `uuid` 作为幂等键不够安全

很多同学一上来就用 uuid.NewString() 生成请求 ID，再存进 Redis 做存在性判断——这看似能防重放，但实际漏掉关键环节：uuid 是客户端生成的，服务端无法验证它是否被恶意复用或伪造。更严重的是，如果客户端因超时重试而携带了同一个 idempotency-key，但后端没校验该 key 对应的**前次响应状态和结果**，就可能重复扣款或发券。

真正安全的幂等校验必须绑定「请求内容 + 业务上下文 + 状态机」，而不仅仅是“有没有见过这个 key”。

客户端需在请求头传固定字段，如 Idempotency-Key（建议长度 32~64 字符，避免含特殊符号）
服务端收到后，先查缓存（如 Redis），若命中且状态为 succeeded，直接返回上次响应体（含相同 HTTP Status 和 body）
若命中但状态为 processing，应返回 409 Conflict 或等待轮询，而非继续执行
首次见该 key，才允许进入业务逻辑，并立即写入 processing 状态（带过期时间，如 10 分钟）

如何用 `redis.SetNX` 配合状态机落地幂等流程

Go 标准库不直接支持带过期时间的原子 set-if-not-exists，得靠 redis.Client.SetNX（Redigo 或 go-redis 都有对应方法）。注意：不能先 GET 再 SET，那是竞态漏洞。

示例中用 go-redis：

ctx, cancel := context.WithTimeout(r.Context(), time.Second*3)
defer cancel()

key := "idemp:" + r.Header.Get("Idempotency-Key")
status, err := rdb.Get(ctx, key).Result()
if err == redis.Nil {
    // 第一次见，抢占 processing 状态
    ok, _ := rdb.SetNX(ctx, key, "processing", 10*time.Minute).Result()
    if !ok {
        http.Error(w, "conflict", http.StatusConflict)
        return
    }
    // 执行业务逻辑...
    result := doBusiness(r)
    // 成功后更新为 succeeded 并写入响应快照（可选）
    rdb.Set(ctx, key+":result", result, 24*time.Hour)
    rdb.Set(ctx, key, "succeeded", 24*time.Hour)
} else if status == "succeeded" {
    // 直接返回缓存结果（需提前存好）
    cached, _ := rdb.Get(ctx, key+":result").Result()
    w.Header().Set("X-Idempotent-Response", "true")
    w.Write([]byte(cached))
} else {
    http.Error(w, "processing", http.StatusAccepted)
}

这里的关键是：SetNX 必须带过期时间，否则节点宕机后 key 永久卡在 processing；且状态值不能只写 true 这类布尔量，要明确区分 processing/succeeded/failed 三态。