阿里云短信接口验证码发送失败排查指南
一、检查基础配置与权限
首先确认短信服务是否完成初始化配置:
- 登录控制台检查短信服务是否已开通且账号状态正常
- 验证AccessKey是否具备
AliyunDysmsFullAccess
权限 - 确保短信签名和模板已通过审核,且处于「已生效」状态
二、验证参数正确性
调用接口时需注意以下关键参数:
- 手机号格式需包含国际区号(如+86),且无空格等特殊字符
- 模板参数需与审核通过的变量占位符完全匹配
- 签名名称必须与审核通过的签名完全一致
建议通过控制台的「测试发送」功能验证参数组合。
三、处理频率限制与配额
阿里云默认设置如下防护机制:
- 单手机号每小时最多接收5条验证码
- 每个账号默认日发送限额为1000条
可通过查询短信发送统计
接口查看当前用量,若触发限流建议间隔30分钟重试。
四、排查网络与系统问题
当基础配置正确仍发送失败时:
- 检查服务器到
dysmsapi.aliyuncs.com
的网络连通性 - 验证SDK版本是否过旧,建议升级到最新版本
- 查看错误日志中的
Code
字段,对照官方错误码表排查