验证码有效性必须由服务端TTL控制,前端倒计时不可信;Redis存储需用SetNX+显式过期时间(如5*time.Minute),校验时用Get+exists检查并优先使用GETDEL防重放。

验证码不能只靠前端倒计时控制过期
用户看到的“120秒后重新发送”只是视觉提示,完全不可信。浏览器关闭、网络中断、手动修改系统时间都会让这个倒计时失效。真正决定验证码是否有效的,是服务端存储时设置的 TTL(time-to-live)。Fiber 本身不内置验证码逻辑,但你用 Redis 或内存缓存时,必须显式传入过期时间,而不是依赖任何“默认值”或前端反馈。
用 Redis 存验证码时,SetNX + 5 * time.Minute 是基础操作
直接调 rdb.Set(ctx, key, value, 0) 等于把验证码设为永不过期,极易被枚举爆破。正确写法是:
_, err := rdb.SetNX(ctx, "captcha:"+ipHash, code, 5*time.Minute).Result()
if err != nil {
// 网络错误或 Redis 不可用
}
// 注意:SetNX 返回 false 不报错,只表示 key 已存在
-
SetNX防止并发重复发码(比如用户狂点“获取验证码”) -
5 * time.Minute是显式秒级 TTL,Redis-go 会自动向下取整转成整数秒;别用time.Hour * 24这类大跨度计算,Go int64 可能溢出 - key 建议哈希化,例如
"captcha:" + fmt.Sprintf("%x", md5.Sum([]byte(ip+ua))),避免被按 IP 枚举
校验时别用 Cache::get() 直接比对,先 Cache::has()
Redis 的过期是惰性删除 + 定期抽样,GET 可能返回 nil 或旧值(已过期但还没被清理),导致误判。Laravel 的 Cache::has() 底层走的是 EXISTS,更可靠;Fiber 中若用 github.com/redis/go-redis/v9,应手动检查:
val, err := rdb.Get(ctx, key).Result()
if errors.Is(err, redis.Nil) {
// key 不存在或已过期 → 验证失败
} else if err != nil {
// 真正的错误
} else if val == inputCode {
// 再执行 GETDEL 原子删掉,防重放
_, _ = rdb.GetDel(ctx, key).Result()
}
- 不要用
GET+DEL两步,中间有竞态窗口 -
GETDEL是 Redis 6.2+ 原生命令,Fiber 调用它不需要额外封装,但要确保 Redis 版本达标 - 验证失败时不要
DEL或forget,留给 TTL 自动回收,否则用户刷新页面就收不到新码
Fiber 中集成缓存驱动要注意 Cache 实例的 TTL 透传
Fiber 没有内置 Cache 组件,你大概率会自己封装一个基于 Redis 或 github.com/patrickmn/go-cache 的实例。关键点在于:所有写入操作都必须带过期参数,且不能在封装层里“默认补 5 分钟”。
- 如果用
go-cache,Set(key, value, 5*time.Minute)是 OK 的,但注意它的 TTL 是基于本地时钟,不适用于多实例部署 - 如果用 Redis,务必确认你调用的 client 方法最终落到
SETEX或SET ... EX命令,而不是SET无过期 - 别在中间件里统一加 TTL —— 不同业务场景需要不同有效期(登录验证码 5 分钟,修改邮箱 10 分钟,敏感操作 2 分钟)
最易被忽略的是:开发时用本地内存缓存测试没问题,一上生产换 Redis 就出问题,因为两个驱动对 “未设 TTL” 的行为不一致 —— 内存缓存可能默认永不过期,Redis 则根本不会加 TTL。必须每一处 Set 都显式传参。


















