一、模板状态异常
阿里云短信模板需通过审核并保持启用状态才能生效。若模板处于审核中或已过期状态，调用接口时会返回“模板无效”错误。建议通过控制台检查模板的审核状态和有效期。
常见状态异常场景：
- 新创建的模板未提交审核
- 审核被驳回未修改重新提交
- 模板内容涉及敏感信息被系统禁用
二、模板ID配置错误
调用短信API时需传入与模板对应的唯一标识符。以下情况会导致模板未找到：
- 开发环境与生产环境模板ID混淆
- 手动输入ID时发生字符遗漏或拼写错误
- 未同步更新代码中的模板ID
建议通过短信服务>模板管理页面核对ID，并使用复制功能避免手动输入错误。
三、模板参数不匹配
当模板变量与实际传输参数不一致时，系统会提示模板无效。需特别注意：
- 变量命名区分大小写，如{code}与{Code}视为不同参数
- JSON格式必须严格符合规范，避免多余引号或符号
- 非必填参数也需保留空值占位符
建议使用阿里云提供的API调试工具验证参数格式，确保键值对完全匹配模板定义。
四、接口与服务端问题
部分特殊场景可能导致误报模板错误：
- SDK版本过旧不支持新模板类型
- 服务端限流策略触发时的错误混淆
- 跨区域调用未配置国际短信模板
遇到持续报错时，建议检查API请求中的RegionId参数，并确认SDK已更新至最新版本。
阿里云短信模板报错多由配置链路的环节疏漏导致。建议按照模板状态→ID核对→参数验证→接口调试的顺序进行排查，同时利用控制台的消息查询功能追踪具体错误码，可快速定位问题根源。
