uniCloud短信服务需先开通并配置环境变量smsKey/smsSecret,调用uniCloud.sendSms必须使用审核通过的templateId和字符串数组data,手机号须带+86前缀,前后端需协同限流与校验。

uniCloud 短信服务必须先开通并配好 smsKey/smsSecret
没开通短信服务,uniCloud.callFunction 调用发送验证码的云函数一定会报错,比如 ERR_SMS_SERVICE_NOT_ENABLED 或直接返回空对象。开通入口在 DCloud 开发者中心 → uniCloud 控制台 → 左侧「短信服务」→ 「立即开通」。开通后你会拿到 smsKey 和 smsSecret,这两个值绝不能写死在前端或云函数源码里,必须设为云函数环境变量(如 process.env.SMS_KEY)。
常见卡点:
- 开通按钮灰色 → 检查是否完成实名认证(个人支付宝认证最快)
- 控制台看不到
smsKey→ 当前账号权限不足,需主账号或拥有「开发者」角色 - 开通成功但调用失败 → 查看服务区域是否与你的云服务空间一致(例如阿里云华东1区 ≠ 华南1区)
云函数里调用 uniCloud.sendSms 必须传 templateId 和 data
uniCloud.sendSms 是 uniCloud 提供的封装方法,它不接受裸手机号+验证码字符串,而是强制走模板化发送。你得先在 DCloud 控制台提交短信模板(如「您的验证码是{1},5分钟内有效」),审核通过后获得一个 templateId(形如 SM12345678)。云函数中调用时必须带上这个 ID 和对应占位符数据:
await uniCloud.sendSms({
phoneNumber: '+86' + event.phone,
templateId: 'SM12345678',
data: [event.code] // 注意:data 是字符串数组,顺序对应模板里的 {1} {2}...
})
容易踩的坑:
- 模板未审核通过就调用 → 返回
ERR_TEMPLATE_NOT_APPROVED -
data类型写成对象或单个字符串 → 接口直接拒绝,不报错但无短信发出 - 手机号没加
+86前缀 → 国内号码必须带国际区号,否则被当作无效号码丢弃
前端倒计时和按钮禁用逻辑要和后端状态对齐
前端点击「获取验证码」后启动 60 秒倒计时,但这个倒计时只是 UI 层反馈;真正防重发、防刷靠的是后端 Redis 限流(比如 60 秒内同一手机号最多 1 次)。如果前端倒计时结束就允许再次点击,但后端因限流拒绝请求,用户会看到「发送失败」却不知原因。
建议做法:
- 前端发起请求后,立即将按钮
disabled,并开始倒计时 - 后端云函数成功发送后,才把倒计时状态存入 Redis(key 为
verify:phone:${phone},ttl 设为 60) - 前端下次点击前,可先
uniCloud.callFunction({ name: 'checkCodeAvailable', data: { phone } })查询是否可发,避免盲目请求
手机号格式校验不能只靠前端正则
前端用 /^1[3-9]\d{9}$/ 判断手机号看起来没问题,但绕过校验非常容易(比如抓包改请求、禁用 JS 后手动填)。真正有效的校验必须落在云函数里:
if (!/^1[3-9]\d{9}$/.test(event.phone)) {
throw new Error('INVALID_PHONE_FORMAT')
}
更稳妥的做法是结合运营商号段库(如工信部公开号段)做二次验证,或调用第三方号码归属地 API(如阿里云号码认证服务)预检。单纯依赖正则,上线后大概率被恶意注册脚本打穿。
最后提醒一句:所有涉及短信发送的云函数,务必开启 HTTPS 触发器,并在 function.json 中配置 "https": true;否则 H5 端可能因混合内容被浏览器拦截,连请求都发不出去。


















