必须通过服务端中转调用腾讯云短信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 存在就认为成功。
