一、模板审核未通过
阿里云短信模板需通过人工审核才能生效。若模板内容包含敏感词、变量格式错误或未完成企业实名认证，系统将拒绝模板申请。建议在控制台的「短信服务」-「国内消息」模块检查模板状态，显示「审核通过」方为有效模板。
二、参数匹配性问题
模板变量与实际参数不匹配是常见错误。例如模板定义为${code}但调用时传参为{"验证码":"1234"}，此时需确保：
- 变量名与模板定义完全一致
- 必填参数未遗漏
- 参数值类型符合要求
三、权限配置缺失
若出现isv.SMS_TEMPLATE_ILLEGAL错误，需检查RAM用户是否被授予AliyunDysmsFullAccess权限。同时确认API密钥状态正常，访问策略未设置地域/IP限制。
四、签名模板未关联
短信签名与模板需建立绑定关系。建议通过以下步骤排查：
- 在控制台检查签名审核状态
- 确认模板管理页已关联有效签名
- 测试时使用已绑定的签名+模板组合
五、参数格式错误
JSON格式错误会导致模板解析失败，常见问题包括：
- 未转义特殊字符如双引号
- 参数值未包含在引号中
- 存在多余逗号或括号
阿里云短信模板ID无效问题多由审核流程、参数配置、权限控制三方面因素导致。建议开发者遵循「创建模板→审核通过→参数匹配→权限验证→接口调用」的标准化流程，同时利用控制台的API调试功能进行预验证，可有效降低错误发生率。
