推荐用 base64Captcha 库而非手动绘图,因其封装字体、噪声、旋转等抗OCR策略,直接输出 base64 字符串;需复用 driver、替换默认内存存储、绑定 IP 校验、设 120 秒 TTL 并及时删除、禁用 debug 及定制字符集。

如何用 Go Fiber 生成 Base64 图片验证码
直接返回图片二进制会破坏 HTTP 响应结构(尤其配合 JSON API 时),推荐统一返回 Base64 字符串 + 验证码 ID。Fiber 没有内置图形库,需搭配 image 和 draw 包手动绘制。
关键点:避免使用 jpeg.Encode 直接写入 c.Response().BodyWriter(),否则后续无法再写 JSON;改用内存 bytes.Buffer 编码后转 Base64。
- 用
image.NewRGBA创建画布,尺寸建议120x40,太小易误识别,太大增加传输开销 - 字符集避开易混淆字符(如
0/O, 1/l/I),推荐"23456789ABCDEFGHJKLMNPQRSTUVWXYZ" - 干扰线控制在
5~8条,过多影响 OCR 可读性;干扰点数量建议80~120个 - 字体用系统默认
font/basicfont.Face7x13即可,无需嵌入 TTF 文件,降低部署复杂度
示例片段:
buf := &bytes.Buffer{}
png.Encode(buf, img) // 注意用 png,比 jpeg 更适合文字图形
c.JSON(fiber.Map{
"captcha_id": captchaID,
"image": "data:image/png;base64," + base64.StdEncoding.EncodeToString(buf.Bytes()),
})
Fiber 中如何安全存储与校验验证码
不能存 Session(Fiber 默认不带 session 中间件),也不建议全量存 Redis —— 验证码本质是短时效、高淘汰率数据,用带 TTL 的内存缓存更轻量。
github.com/gofiber/fiber/v2/middleware/cache 不适用,它缓存的是 HTTP 响应,不是业务数据。应手写简易 TTL map 或用 github.com/bluele/gcache。
- 缓存 key 必须包含客户端标识(如 IP + User-Agent 哈希前 8 位),防暴力穷举
- TTL 设为
120秒足够,过长增加被复用风险,过短影响用户体验 - 校验时立即
Delete对应 key,防止一次验证码多次提交 - 校验忽略大小写,但存储原始值(便于日志审计)
错误现象:captcha not found 多因前端未正确携带 captcha_id,或后端未对齐缓存 key 构造逻辑。
为什么校验接口常返回 400 却没提示具体原因
这是故意设计:暴露“验证码错误”或“已过期”会帮攻击者做条件判断。统一返回 400 Bad Request + 泛化 message(如 "verification failed"),不区分失败类型。
- 不要在 response body 里写
"captcha expired"或"wrong code" - 日志中记录完整信息(IP、captcha_id、时间、原始输入),仅用于运维排查
- 连续 3 次失败后,可临时对该 IP 延长验证码 TTL 或要求二次验证,但不要阻断请求
注意:Fiber 的 c.Status(400).JSON(...) 后必须 return,否则可能触发 panic —— 中间件链未中断,后续 handler 仍执行。
前端传来的验证码如何防自动填充和粘贴绕过
纯前端限制形同虚设,但可增加基础防护降低脚本批量成功率。
- 输入框加
autocomplete="off"和autocapitalize="none",部分浏览器会禁用自动填充 - 监听
paste事件,setTimeout延迟 100ms 再校验长度,过滤掉瞬间粘贴的异常行为 - 服务端校验时,检查该
captcha_id是否在 5 秒内被同一 IP 请求过 >2 次,是则标记可疑 - 不依赖前端 JS 生成时间戳或签名,所有有效性判断必须由服务端完成
真正难防的是 OCR 自动识别 + 表单自动提交,这类场景需结合行为分析(鼠标轨迹、点击间隔)或升级为滑块/点选式验证码 —— 但那就超出纯 Fiber 图片验证码范畴了。











