一、模板参数与内容不匹配
当短信模板中定义的变量与代码中传递的参数不一致时，系统会返回错误码isv.SMS_TEMPLATE_ILLEGAL。例如模板要求两个必填参数但仅传递一个，或参数名称与模板变量不匹配，均会导致配置失败。建议检查JSON格式参数的键值对是否完全对应模板变量名。
{
code": "isv.SMS_TEMPLATE_ILLEGAL",
message": "请检查模板内容与模板参数是否匹配
}
二、签名与模板未正确关联
阿里云要求短信签名必须与模板绑定使用。若在发送请求时使用的签名未在控制台关联对应模板，或签名内容与模板中声明的签名不一致，将直接导致服务拒绝请求。需在「短信服务-签名管理」中确认关联关系。
- 签名需包含中英文括号等特殊字符时需官方审核
- 国际短信需匹配对应国家/地区规范
三、模板审核状态异常
未通过审核或审核过期的模板无法用于生产环境。常见问题包括：
- 模板内容包含敏感词或违规营销信息
- 变量占位符格式错误（如未使用${param}格式）
- 验证码类模板缺少有效时间说明
四、接口配置参数错误
SDK调用时需特别注意以下配置项：
- AccessKey密钥对失效或权限不足
- 地域节点选择错误（如国内业务误用国际版节点）
- API版本不兼容导致参数无法识别
建议通过阿里云提供的API调试工具进行实时校验。
模板配置失败的核心问题集中于参数一致性、审核合规性和接口准确性三个维度。建议开发者通过控制台「发送记录查询」功能定位具体错误阶段，同时定期检查模板有效期和权限策略，可减少90%以上的配置类故障。
