验证码生成最常用库是 github.com/mojocn/base64Captcha,支持数字/字母/算术题,输出 base64 字符串;需用 Redis 存储 ID 与答案绑定,校验前须 TrimSpace 和 ToLower 并用 EqualFold 比对。

验证码生成用什么库?别自己写 rand.Seed
Go 生态里最成熟、Gin 项目里最常用的图形验证码库是 github.com/mojocn/base64Captcha。它自带字体、支持数字/字母/算术题,且输出为 base64 字符串,前端直接用 img src="data:image/png;base64,xxx" 就能渲染,省去文件存储或 HTTP 接口托管的麻烦。
常见错误是手写随机字符串 + 手绘图像:容易撞 seed(rand.Seed(time.Now().UnixNano()) 在高并发下可能重复)、缺少抗 OCR 干扰(如扭曲、噪点、干扰线),导致验证码形同虚设。
- 初始化时必须传入
config,尤其注意Width/Height和Len,太小易被识别,太大拖慢前端渲染 -
driverString比driverMath更常用,但后者需额外校验运算结果,适合防爬更严场景 - 生成后立即调用
store.Set(id, answer)存入 Redis(不建议用内存 map,多实例部署会失效)
Gin 中怎么把验证码 ID 和答案绑定到 session 或 Redis?
验证码本质是「一次一密」,ID 必须与答案强绑定,且有过期时间。Gin 本身无内置 session,硬编码用 map[string]string 会导致并发读写 panic,也撑不住多节点部署。
推荐直接对接 Redis:SET key value EX 180(180 秒过期),key 用 UUID 或时间戳+随机数拼接,避免 predictability;value 存纯答案(如 "aB3x"),不要存结构体 JSON —— 校验时只需 GET + strings.EqualFold。
- Redis key 建议加前缀,比如
"captcha:" + id,方便批量清理 - 生成接口返回的
id必须原样透传给校验接口,不能做任何 base64 或 hex 编码,否则前后端不一致 - 校验失败时,应立即
DEL captcha:xxx,防止重放
短信验证码发不出去?排查三件事:签名、模板、手机号格式
国内短信服务(阿里云、腾讯云、容联云)拒绝发送的最常见原因不是代码逻辑错,而是平台侧配置问题。Gin 后端调用 SDK 只是最后一环,前面卡住就永远看不到 HTTP 200。
以阿里云为例,错误信息 "InvalidParameter.TemplateCode 或 "isv.BUSINESS_LIMIT_CONTROL" 都说明没过平台审核,跟 Go 代码无关。
- 签名名称必须和提交审核通过的完全一致(包括空格、标点),且已启用;模板 Code 要复制控制台显示的
SMSTPL_xxx,不是你起的中文名 - 手机号必须带国际区号,国内是
"+8613800138000",漏掉+或86直接被拒 - 发短信前先查 Redis 是否已有未过期的
"sms:13800138000",有则拒绝新请求(防轰炸),key 过期时间建议设 60–120 秒
前端传来的验证码对不上?大小写、空格、trim 是隐形杀手
用户输入框粘贴、移动端自动补全、中文输入法残留空格,都会让 "abc1 " ≠ "abc1"。后端不做清洗就直接比对,90% 的「验证码错误」其实来自这里。
校验逻辑必须在 compare 前统一处理:
- 对用户提交的
captcha字段执行strings.TrimSpace+strings.ToLower(如果后端存的是小写) - Redis 里存的答案也必须是小写(
strings.ToLower(answer)),别依赖前端大小写一致 - 别用
==直接比 string,用strings.EqualFold(a, b)更安全,它忽略大小写且不 panic
短信验证码同理,手机号字段也要 strings.ReplaceAll(input, " ", "") 清掉所有空格再校验。











