阿里云短信模板参数为何总报错？

参数格式不符合规范

阿里云短信模板参数要求严格的JSON格式，包括双引号、冒号等符号必须使用英文半角字符。开发者在代码中拼接参数时，容易因转义字符处理不当导致格式错误。例如调试工具生成的参数复制到代码中可能额外增加转义斜杠，此时应通过日志工具验证实际传输的JSON结构。

签名与模板未正确关联

短信签名需在控制台与模板建立绑定关系，且签名类型必须与模板类型匹配。验证码类签名仅限发送验证码模板，通用签名可支持通知和推广类模板。若出现isv.SMS_SIGNATURE_SCENE_ILLEGAL错误，表明存在签名类型与模板类型冲突。

必填参数缺失或冗余

模板参数存在以下两类常见问题：

• 必填参数未完整传递，导致系统无法替换模板变量
• 传递了模板未声明的参数，触发参数校验异常

需严格对照审核通过的模板内容，确保传入参数的键名完全一致。例如模板要求{"code":1234}时，参数名使用code而非verificationCode。

模板状态异常

已通过审核的模板可能因以下原因变为不可用状态：

1. 签名资质过期导致关联模板失效
2. 模板内容被主动撤回或修改
3. 账户欠费触发服务限制

建议定期在控制台检查模板的审核状态和有效期，出现isv.SMS_TEMPLATE_ILLEGAL错误时应重新核对模板基本信息。