一、签名问题排查
签名审核状态是短信发送失败的首要检查项:
- 确认签名已通过阿里云审核,未通过审核的签名无法发送
- 检查签名类型与应用场景是否匹配,验证码类签名不能用于通知短信
- 确保RAM账号具备短信服务操作权限,需分配AliyunDysmsFullAccess策略
二、模板配置检查
模板错误会导致参数解析异常:
- 登录控制台确认模板状态为审核通过
- 核对模板变量数量与代码中参数个数是否一致
- 国际短信需使用专用模板,不可与国内模板混用
模板变量 | 参数键名 |
---|---|
${code} | 必须包含”code”字段 |
${expire} | 需对应”expire”参数 |
三、参数匹配验证
参数错误是触发模板匹配异常的常见原因:
- 使用标准JSON格式传递参数,确保键名与模板变量完全一致
- 必填参数必须包含有效值,非必填参数可置空但需保留字段
- 特殊字符需进行转义处理,如双引号应转换为\”
四、其他常见问题
系统级限制可能影响发送成功率:
- 检查账号余额和短信包余量是否充足
- 确认未触发日/月发送量限额(默认200条/日)
- 验证服务器IP是否在中国内地(国际短信除外)
- 测试网络连接是否正常,建议使用VPC内网访问
通过签名审核、模板配置、参数验证的三层检查可解决90%的发送失败问题。若仍无法解决,建议通过控制台消息服务日志获取详细错误码,或联系阿里云技术支持。