必须通过服务端中转调用腾讯云短信API,前端仅能发起uniCloud.callFunction或uni.request请求;密钥须存环境变量,云函数需安装@cloudbase/uni-app-adapter并调用useAdapter();Sign、TemplateId须审核通过,手机号须服务端校验,测试号需加白名单,返回结果需检查SendStatusSet[0].Code。

不能在 uni-app 前端直接调用腾讯云短信 API,必须走服务端中转——这是硬性安全要求,不是“建议”。所有主流短信平台(包括腾讯云 SMS)强制服务端签名鉴权,SecretId 和 SecretKey 一旦出现在前端代码里,打包后可被反编译提取,真机必然失败,且可能被恶意刷量封号。
uni-app 前端调用腾讯云短信的唯一合法路径
前端只能发起一个请求:uniCloud.callFunction(推荐)或 uni.request 调自有后端接口。二者本质相同,区别在于部署位置:
- 用
uniCloud:密钥存在云函数环境变量中,无需自己运维服务器,适合中小项目 - 用自建后端(Node.js/PHP/Java):需自行部署、配置 HTTPS、做防刷限流,但更可控、易审计
无论哪种,前端都只传手机号(phone)、场景标识(如 scene: "login"),不碰任何腾讯云 SDK 参数。
云函数里调腾讯云 SMS SDK 的关键适配点
直接 require('tencentcloud') 在 uniCloud 里会报错,因为运行时缺少底层适配层。必须按官方规范接入:
腾讯云通用票据识别高级版(VatInvoiceOCR)接口调用技能。当用户需要识别发票图片中增值税专用发票、增值税普通发票、增值税电子专票、增值税电子普票、电子发票(普通/增值税专用)的全字段信息时,应使用此技能。支持识别发票图片中的发票代码、发票号码、开票日期、合计金额、校验码、税率、合计税额、价税合计、购买方...
- 安装适配包:
npm install @cloudbase/uni-app-adapter - 在云函数入口顶部调用:
useAdapter(),否则TencentCloud初始化失败 - 密钥必须从环境变量读取:
process.env.TENCENT_SECRET_ID、process.env.TENCENT_SECRET_KEY,严禁硬编码 - 注意腾讯云 SMS 接口要求
SmsSdkAppId(非 SDKAppID)、Sign(已审核通过的签名)和TemplateId(已审核模板),缺一不可
示例片段(云函数内):
const { SmsClient } = require('tencentcloud-sdk-nodejs/tencentcloud/services/sms/v20210111');
const { useAdapter } = require('@cloudbase/uni-app-adapter');
useAdapter(); // 必须!否则 client.newClient 报错
exports.main = async (event, context) => {
const client = new SmsClient({
credential: {
secretId: process.env.TENCENT_SECRET_ID,
secretKey: process.env.TENCENT_SECRET_KEY
},
region: 'ap-guangzhou',
profile: { httpProfile: { endpoint: 'https://sms.tencentcloudapi.com' } }
});
// 后续调用 SendSms...
}
常见真机失败原因与对应检查项
开发工具里“发送成功”,但手机收不到验证码?大概率卡在这几处:
-
Sign或TemplateId未通过腾讯云审核——控制台看状态是否为“已通过”,别信“提交中” - 手机号格式没校验:
/^1[3-9]\d{9}$/必须在服务端做,前端正则只是体验优化 - 云函数超时:腾讯云默认 60 秒,发短信+Redis 写入+日志落盘叠加后容易超,加
context.getRemainingTimeInMillis()监控 - 短信内容含敏感词或变量名写错:模板里写的是
{1},你传了{code},会静默失败 - 测试手机号未加白名单:腾讯云新账号默认仅支持已添加的测试号码,控制台「国内短信」→「短信签名」→「测试号码管理」里补全
最易被忽略的一点:腾讯云短信接口返回的 SendStatusSet 是数组,哪怕只发一个号,也要取 [0].Code === 'Ok' 判断,不能只看顶层 Response.RequestId 存在就认为成功。










