阿里云短信模板为何无法正常调用？

模板审核未通过

阿里云要求所有短信模板必须通过内容审核方可使用。若模板包含敏感词、营销性质内容或格式不规范（如缺少签名、变量占位符错误），将导致审核失败。用户需在控制台查看审核状态，修改后重新提交申请，并确保符合《阿里云短信服务规范》要求。

参数与模板内容不匹配

调用模板时需严格遵循以下规则：

• 必填参数未完整传递或变量名拼写错误
• 参数值与模板变量类型冲突（如数字类型填入字符串）
• JSON格式错误，例如缺少引号或大括号未闭合

建议使用阿里云官方调试工具验证参数结构，并检查控制台模板详情页的变量定义。

权限配置或API密钥异常

以下权限问题可能阻断模板调用：

1. RAM子账号未授予短信服务操作权限（如SendSms）
2. API密钥状态异常（过期或未启用）
3. 访问策略限制特定IP或时间段操作

需在RAM控制台检查权限策略，并通过「访问控制」更新密钥状态。

触发频率限制机制

阿里云为防止滥用设置了三级限流规则：

• 单模板每分钟调用上限（默认200次）
• 同一手机号每日接收次数限制（默认10次）
• 新模板24小时内调用频次阈值

建议通过控制台「用量统计」监测调用数据，或申请调整阈值。

短信模板调用失败通常由内容审核、参数传递、权限配置或频率限制引发。开发者应优先检查模板审核状态与参数匹配度，再排查权限策略和调用频率。阿里云控制台提供的调试工具和错误码说明文档（如Code: isv.SMS_TEMPLATE_ILLEGAL）可加速问题定位。