Beego不提供短信能力,需集成第三方SDK或HTTP接口;验证码核心在于Redis存储、时效校验与双层频控。不能在controller中同步发短信,应封装为service,用带用途前缀的Redis key存码并设5分钟过期,校验时严格顺序比对并防重放。

Beego 本身不提供短信发送能力,必须集成第三方 SDK 或 HTTP 接口;验证码流程的核心不在框架层,而在状态存储、时效校验和防刷控制。
为什么不能直接用 beego.Controller 发短信?
Beego 的控制器只负责 HTTP 请求分发和响应组装,SendSMS 这类 I/O 操作必须由业务逻辑层调用外部服务完成。常见错误是把短信发送写在 Post 方法里同步执行,导致接口卡顿甚至超时。
- 短信网关平均响应在 300–800ms,HTTP 超时设为 2s 都可能失败
- Beego 默认的
context.Input.SetData不适合存验证码(无过期、无隔离) - 未做频率限制时,攻击者可暴力刷
/api/send_code接口
验证码如何安全存到 Redis 并设置过期?
别用本地 map 或文件存验证码——Beego 多实例部署时会失效。必须用 Redis,且 key 设计要带手机号 + 用途前缀,避免冲突。
示例代码片段(使用 github.com/go-redis/redis/v8):
ctx := context.Background()
key := fmt.Sprintf("sms:verify:%s:login", phone)
err := rdb.Set(ctx, key, code, 5*time.Minute).Err()
if err != nil {
// 记录日志,返回 500
}
- key 中的
login可替换为register或reset,便于区分场景 - 过期时间建议 5 分钟,太短影响用户体验,太长增加被撞库风险
- 务必检查
rdb.Set返回的err,Redis 连接失败时需降级处理(如记录告警但不阻断)
调用阿里云/腾讯云 SDK 发送短信要注意什么?
别裸写 HTTP 请求——签名、时间戳、签名加密都容易出错。必须用官方 SDK,并注意配置项命名差异。
- 阿里云 SDK 初始化要用
alisms.NewClient,AccessKeySecret 必须从环境变量读取,禁止硬编码 - 腾讯云的
sms.DefaultClient需显式传入credential.Credential和regions,region 写错(如填ap-guangzhou而非ap-guangzhou)会导致InvalidRegion错误 - 模板 ID(
TemplateID)和签名名称(SMS_SignName)必须已在控制台审核通过,否则返回TemplateNotExist - 发送失败时,SDK 通常返回结构体含
Code字段(如isv.BUSINESS_LIMIT_CONTROL),需解析后映射成用户友好的提示
Beego 路由与验证码校验怎么配合?
校验接口(如 POST /api/verify_code)必须和发送接口分离,且校验逻辑不能复用发送时的缓存 key——要严格比对手机号、验证码、是否已使用。
关键判断顺序不能乱:
- 先查 Redis,key 存在且值匹配 → 继续
- 再检查该 key 是否已被标记为“已使用”(可用
SETEX或额外字段标识) - 最后才允许业务逻辑执行(如登录、注册),并立即
DEL该 key 防重放
Beego 中建议封装成独立 service 函数,例如:VerifySMSCode(ctx context.Context, phone, inputCode string) (bool, error),不要塞进 controller。
最容易被忽略的是:短信通道本身有频控(如阿里云单号码 1 小时最多 10 条),这个限制和你应用层的限流(如 Beego 的 middleware.RateLimit)是两层,必须同时配,否则用户看到的错误码会混乱。











