uni-app怎么调用腾讯云短信服务

落浩同学_6627

落浩同学_6627

2026-11-01

603人浏览

原创

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

uni-app怎么调用腾讯云短信服务

不能在 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 存在就认为成功。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

uni-app 腾讯云

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2763

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6003

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6930

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6718

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

963

5

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.16

5490

6

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

60

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

40

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

140

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习