必须通过后端或uniCloud云函数中转调用短信API,禁止前端直接调用;前端请求/api/send-sms须携带scene字段(如"register")以支持分场景限流;倒计时需绑定页面生命周期并三重防护;云函数内用uniCloud.sendSms()发送,密钥严禁暴露前端;手机号格式校验和Redis限流key(sms:rate_limit:{phone}:{scene})必须后端实现。

不能在 uni-app 前端直接调用短信平台 API 发送验证码,必须走自有后端或 uniCloud 云函数中转;否则密钥暴露、请求被拒、真机收不到码——这是绝大多数人卡住的第一关。
uni.request 调用 /api/send-sms 必须带 scene 字段
后端需要区分用途来控制策略:注册、重置密码、绑定手机等场景的频率限制、有效期、是否允许重复发送都不同。只传手机号不传 scene,会导致风控逻辑失效。
- 前端请求必须携带
scene字段,值为字符串,如"register"、"reset-pwd"、"bind-phone" - 后端用 Redis 存 key 时拼成
sms:rate_limit:{phone}:{scene},避免跨场景干扰 - 返回给前端的错误码要明确,例如
{ code: 429, msg: "操作过于频繁,请60秒后再试" },方便前端统一提示
倒计时按钮状态管理必须绑定页面生命周期
常见错误现象:切后台再切回,倒计时卡在 5 秒不动;多个页面同时打开,一个页面倒计时结束,另一个页面按钮突然变可点;点击两次“获取验证码”,倒计时加速翻倍。
- 用
onUnload或onHide钩子主动调用clearInterval(timer),不要依赖页面自动销毁 - 倒计时变量用
ref(Vue 3)或data(Vue 2),禁止直接改document.getElementById().disabled - 按钮点击事件第一行加
if (countdown > 0) return,配合:disabled="countdown > 0"和@click.prevent三重防护
uniCloud 云函数里调 uniCloud.sendSms() 才安全
uni.sendsms() 是历史遗留伪 API,HBuilderX 3.6+ 已移除,实际项目中不存在可用的 uni.sendsms 函数。所有合规短信服务(如阿里云 SMS、腾讯云 SMS、容联云)都要求服务端签名鉴权,前端暴露 accessKey 或 secretKey 是严重安全风险。
- 把密钥存在云函数环境变量中,前端只调
uniCloud.callFunction({ name: 'sendcode' }) - 云函数内用
uniCloud.sendSms()发送,传入模板 ID、手机号、参数数组(如['123456']) - 开通短信服务后获得的
smsKey和smsSecret绝对不能写进前端代码或.env文件
真正容易被忽略的是:手机号格式校验必须在后端做 /^1[3-9]\d{9}$/,前端正则只是体验优化;而 Redis 限流的 key 设计若漏掉 scene,就会让“刚注册完立刻点忘记密码”也被拦住——这种交叉干扰,上线后才暴露,排查成本极高。











