阿里云短信发送失败为何提示模板无效？

模板参数与内容不匹配

最常见的原因是模板变量名与调用接口时传递的JSON参数键值不一致。例如模板中定义变量为code，但实际传递参数使用verificationCode会导致校验失败。

需特别注意：

• 非必填参数必须留空或填充默认值
• 变量名需严格区分大小写
• JSON格式必须包含完整花括号

模板未正确添加到代码

在控制台调试成功的模板，若未在SDK中显式声明模板ID，会返回isv.SMS_TEMPLATE_ILLEGAL错误。需在代码中完整配置以下参数：

1. 短信签名名称
2. 审核通过的模板ID
3. 带国家码的手机号格式

调试时建议使用阿里云API在线测试工具验证配置。

签名或模板未通过审核

以下情况会触发模板无效提示：

• 短信签名未提交审核或审核被驳回
• 模板内容包含敏感词或特殊符号
• 模板变量占位符数量不匹配

建议在控制台「短信服务-模板管理」中确认模板状态为审核通过。

参数格式不符合规范

以下格式错误会导致模板验证失败：

• 手机号未包含国际区号（如+86）
• JSON字符串包含转义字符未处理
• 变量值包含HTML标签或超链接

可通过JSON.parse验证参数结构，推荐使用阿里云SDK自带的参数校验工具。

模板无效错误多由配置不一致引发，建议按照「控制台审核→代码匹配→格式验证」的三步排查法定位问题。若仍无法解决，可通过API返回的RequestId查询具体错误日志。