Go语言如何做幂等设计_Go语言接口幂等性教程【避坑】-Golang-PHP中文网

post接口不加幂等控制会重复扣款，因http不保证请求只处理一次，网络超时重试、nginx重发、用户连点等均导致多次执行；go默认无状态，无法自动识别重复请求，需在db层用唯一约束或select...for update+事务兜底，而非依赖易失效的内存缓存或错误使用redis setnx。

go语言如何做幂等设计_go语言接口幂等性教程【避坑】

为什么 `POST` 接口不加幂等控制会重复扣款

因为 HTTP 本身不保证请求只被处理一次：网络超时后前端重试、Nginx 502 自动重发、用户手抖连点——这些都会让同一笔请求抵达后端多次。Go 的 http.HandlerFunc 默认无状态，不会自动识别“这单我见过”，结果就是库存减两次、余额扣两遍。

关键不是“要不要做”，而是“在哪一层拦截最稳”：在数据库写入前校验，比在中间件里靠 X-Request-ID 记日志更可靠。

用数据库唯一约束兜底（如联合索引 (order_id, trace_id)），失败直接返回 409 Conflict
避免依赖内存缓存（如 sync.Map）做去重，进程重启就丢，分布式下更不可靠
不要把幂等键藏在 query string 里——GET 请求可能被 CDN 缓存或代理重放

如何用 `SELECT ... FOR UPDATE` 防并发重复执行

适用于“先查再改”的典型场景，比如查订单状态为 pending 再更新为 paid。单纯 SELECT + UPDATE 有竞态窗口，两个 goroutine 同时查到 pending 就都往下走了。

加行锁能堵住这个缺口，但要注意事务边界和锁粒度：

必须在同一个数据库事务里执行 SELECT ... FOR UPDATE 和后续 UPDATE
WHERE 条件必须命中索引，否则会升级成表锁，拖垮并发
别在事务里做 HTTP 调用或 sleep，锁持有时间越长，阻塞越严重

示例：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

tx, _ := db.Begin()
tx.QueryRow("SELECT status FROM orders WHERE id = $1 FOR UPDATE", orderID).Scan(&status)
if status == "pending" {
    tx.Exec("UPDATE orders SET status = 'paid' WHERE id = $1", orderID)
}
tx.Commit()

`redis.SetNX` 做幂等令牌时的三个失效点

用 Redis 的 SETNX 存 trace_id 是常见做法，但线上容易翻车：

没设过期时间 → 机器宕机后令牌永远卡住，整个业务不可用
过期时间太短（如 1s）→ 正常耗时 1.2s 的请求会被判重复
没校验返回值：Go 的 redis.Client.SetNX 返回 bool，false 不代表失败，可能是 key 已存在 —— 必须检查这个布尔值，不能只看 error

正确姿势：

ok, err := rdb.SetNX(ctx, "idempotent:"+traceID, "1", 30*time.Second).Result()
if err != nil {
    // 处理 Redis 连接错误
}
if !ok {
    return http.StatusConflict, errors.New("duplicate request")
}