在goframe框架中实现接口幂等性,核心策略是利用redis的原子操作(如setnx或lua脚本)配合唯一业务标识进行拦截。具体做法是在中间件或handler前置逻辑中,解析请求中的唯一键(如token或组合参数),尝试向redis写入该键并设置过期时间;若写入成功则放行处理业务,若写入失败则直接返回重复提交错误。此方案能有效防止网络重试或用户快速点击导致的资源重复创建。

如何设计幂等性校验的中间件流程
通过自定义中间件拦截请求,可以在不侵入业务代码的前提下统一处理幂等逻辑。中间件需从请求头或Body中提取唯一标识,调用Redis执行原子判断,根据结果决定是继续执行后续Handler还是中断响应。

package main
import (
"context"
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/net/ghttp"
)
var (
redis = frame.R()
)
// IdempotentMiddleware 幂等性中间件
func IdempotentMiddleware(r *ghttp.Request) {
// 1. 获取唯一标识,这里假设前端在Header中传递Idempotency-Key
key := r.Header.Get("Idempotency-Key")
if key == "" {
r.Middleware.Next()
return
}
ctx := context.Background()
// 2. 使用Lua脚本保证检查与设置的原子性
// KEYS[1]: redis key, ARGV[1]: value, ARGV[2]: expire seconds
luaScript := `
if redis.call("exists", KEYS[1]) == 0 then
redis.call("set", KEYS[1], ARGV[1], "EX", ARGV[2])
return 1
else
return 0
end
`
result := redis.Eval(ctx, luaScript, []string{key}, []string{"processed", "3600"})
// 3. 如果返回0,说明Key已存在,即重复请求
if result.Int() == 0 {
r.Response.WriteJsonExit(frame.H{
"code": 429,
"message": "请求重复,请勿频繁提交",
})
return
}
// 4. 允许通过,执行后续业务逻辑
r.Middleware.Next()
}
func main() {
s := ghttp.NewServer()
s.Use(IdempotentMiddleware)
s.POST("/order/create", func(r *ghttp.Request) {
r.Response.WriteJson(frame.H{
"code": 0,
"message": "订单创建成功",
"data": map[string]interface{}{"orderId": "12345"},
})
})
s.Run()
}
上述代码定义了一个名为 IdempotentMiddleware 的中间件函数。它首先检查请求头中是否存在 Idempotency-Key,若不存在则直接放行。接着,它使用 redis.Eval 执行一段Lua脚本。该脚本先检查Key是否存在,若不存在则设置Key并返回1,若存在则返回0。中间件根据返回值判断是否重复:若为0,则立即输出JSON错误并终止请求;若为1,则调用 r.Middleware.Next() 继续执行后续的Handler逻辑。最后,在 main 函数中注册该中间件到所有路由,确保每个POST请求都经过幂等性校验。
如何处理并发场景下的Redis竞争条件
在高并发环境下,多个请求可能同时到达并尝试获取锁。虽然Redis的单个命令是原子的,但“检查-设置”两步操作若非原子执行,仍可能导致并发穿透。使用Lua脚本或Redis的 SET NX EX 组合命令可以确保这一过程的原子性,从而避免竞态条件。

/test/concurrency











