不能直接用 SET 存验证码,因为传 0 表示永不过期,易被爆破或占满内存;应显式设置有效时长如 5*time.Minute,并用 SetNX 防并发覆盖、GetDel 防重放,手机号需标准化哈希后作为 key。

为什么不能直接用 SET 存验证码?
很多新手会直接用 redis.Client.Set(ctx, "code:138xxxx", "123456", 0),但这里第三个参数是 time.Duration,传 0 表示“永不过期”,不是“用默认过期时间”。Redis 不会自动给 key 加 TTL,不显式设置就永远存在,容易被爆破或占满内存。
正确做法是明确传入有效时长,比如 5 分钟:5 * time.Minute。同时注意:Golang 的 time.Duration 和 Redis 的秒级 TTL 是兼容的,redis-go 底层会自动转成秒(向下取整),所以 59 * time.Second 会被存为 59 秒,60 * time.Second 才是完整 1 分钟。
- 别用
0或time.Duration(0)代替“默认过期”——根本不存在默认值 - 避免用
time.Hour * 24 * 7这种大跨度计算,易溢出;建议写成7 * 24 * time.Hour - 如果业务要求“精确到毫秒级过期”,Redis 原生不支持;得靠应用层轮询或用
redis-stream+ 消费者,但对验证码属于过度设计
SET 的 XX/NX 选项在发码时很关键
用户频繁点击“重新发送”,可能触发并发请求,导致多个 goroutine 同时写同一个手机号的验证码。若不加控制,后写的会覆盖前写的,且过期时间也被重置,造成实际有效期延长,甚至掩盖了限流逻辑。
用 SET 的 NX(not exists)选项可保证“只在 key 不存在时才设值”,配合 EX 一起用,原子完成“首次写入 + 设过期”:
立即学习“go语言免费学习笔记(深入)”;
_, err := rdb.SetNX(ctx, "code:138xxxx", "654321", 5*time.Minute).Result()
if err != nil {
// 注意:SetNX 返回 false 不报错,而是 result == false
// 所以要检查 err == nil && result == false 才是“key 已存在”
}
-
SetNX返回bool,不是 error;err != nil表示网络或 Redis 错误,result == false才表示“没写进去,因为 key 已存在” - 不要用
GET + SET两步操作来模拟,中间有竞态窗口,一定用原子命令 - 如果需要“更新过期时间但不覆盖值”,用
SETEX(即Set方法第三个参数非零即可),不需要NX
校验时用 GETDEL 而不是 GET + DEL
验证码是一次性使用的。如果先 GET 再判断再 DEL,中间可能被重复提交、重放或并发校验,导致同一个码被多次通过。Redis 6.2+ 提供了 GETDEL 命令,原子读取并删除 key,天然防重放。
go-redis v9 默认支持 GetDel 方法:
val, err := rdb.GetDel(ctx, "code:138xxxx").Result()
if errors.Is(err, redis.Nil) {
// key 不存在(已用过或过期)
} else if err != nil {
// 真正的错误
} else {
// val 是原始验证码字符串,且 key 已被删掉
}
- 低于 Redis 6.2 的环境没有
GETDEL,只能退回到EVAL脚本实现原子读删,但增加维护成本 - 别在业务逻辑里手动
DEL:哪怕校验成功后立刻DEL,也挡不住两次几乎同时到达的请求 -
GetDel返回的是string,不是interface{},类型安全,不用再做类型断言
手机号作为 key 时必须做标准化和哈希防护
直接用原始手机号当 key,比如 code:13812345678,会暴露用户隐私,也容易被枚举(遍历手机号批量查是否存在验证码)。更严重的是,某些 Redis 集群模式下,key 名含数字过多可能导致 slot 分布不均。
推荐两级处理:
- 对手机号做简单标准化:去空格、去短横、统一前缀(如补
+86),再统一用strings.TrimSpace和strings.ReplaceAll - 用 SHA256 哈希生成固定长度 key(不加 salt,因无需防彩虹表;加 salt 反而增加校验时还原成本):
"code:" + fmt.Sprintf("%x", sha256.Sum256([]byte(normPhone)))
这样 key 不可逆、长度一致、无信息泄露,也规避了集群 key 分布问题。注意哈希后 key 长度约 64 字符,仍在 Redis key 长度限制内(512MB),完全安全。
真正容易被忽略的是:校验流程中,你必须用**和存码时完全相同的标准化+哈希逻辑**重建 key,否则 GetDel 查不到。这个逻辑一旦散落在多个地方(比如前端传参清洗、中间件清洗、存储前清洗),极易不一致。建议封装成一个纯函数,全局复用。


















