uni-app 仅能通过 plus.messaging.createMessage 唤起原生短信应用预填内容,且仅限 App 端;H5 和小程序无法真正发短信,需改用复制引导或云函数通道发送验证码类短信。

uni-app 无法直接调用系统短信发送接口发送内容到运营商网络,但可以唤起原生短信应用预填内容——这是唯一安全、合规且跨端可用的方式。
uni-app 唤起系统短信界面用 plus.messaging.createMessage
仅在 App 端(iOS/Android)有效,H5 和小程序完全不支持。必须配合 plusReady 生命周期使用,且需在 manifest.json 中勾选「Messaging(消息)」模块权限。
- 调用前必须确保
plus对象已就绪,建议封装成 Promise 包裹uni.getProvider+plusReady回调 -
msg.to必须是字符串数组,哪怕只发一个号码也要写成['138xxxx1234'],否则 Android 可能静默失败 -
msg.body长度超过 70 字(含中文)时,部分安卓机型会自动截断,建议控制在 60 字以内 - iOS 不支持
silent: true,设了也无效;Android 开启静默需额外申请SEND_SMS权限,但静默发送的短信不会进入系统发件箱,且多数厂商已限制该能力
微信小程序和 H5 怎么“发短信”
根本做不到。微信小程序受平台限制,连唤起短信界面都不允许;H5 在 iOS 上可通过 sms: 协议跳转(如 location.href = 'sms:138xxxx1234?body=验证码1234'),但 Android Chrome 已禁用该协议,且无回调、不可控、不兼容 PWA。
- 不要尝试用
uni.request直连任何短信平台 API,密钥必然暴露,账号会被封 - 所谓“H5 发短信”实际只能引导用户复制文本+手动打开短信 App,体验差但唯一可行
- 小程序若需通知用户,应改用
uni.showToast+ 服务通知模板,或走微信订阅消息
为什么不能用云函数或后端发“系统短信”
云函数(如 uniCloud.sendSms)发的是运营商通道短信,不是手机本地的“系统短信”。它走的是短信平台网关,用户收到的是 106 开头的营销/验证码类短信,不会出现在手机短信收件箱的“全部信息”列表里(除非用户主动将该号加入白名单),也无法被 plus.android.getContentResolver 读取。
-
uniCloud.sendSms的phone参数只接受单个手机号,批量要用phoneList(HBuilderX 3.3.0+) - 模板必须提前在 DCloud 后台报备通过,测试阶段可用系统提供的通用模板 ID(如
UNICLOUD_TEST) - 发送失败常见原因是
smsKey/smsSecret未配置进云函数环境变量,或templateId拼写错误(注意大小写)
真正需要“系统级短信”的场景极少,比如调试短信读取权限或做设备绑定验证;绝大多数业务需求其实只需要“唤起编辑框”或“走通道发验证码”,别把两者混淆。权限申请、协议兼容、渠道限制——每个环节都卡得死死的,绕不开。


















