一、验证模板ID准确性
当出现模板ID无效提示时，需优先检查以下内容：
- 核对控制台获取的模板ID是否与调用API时填写的一致，避免人工复制错误
- 确认模板所属地域与API调用区域匹配，国际版/国内版账号模板不可混用
- 检查模板ID是否包含特殊字符或空格，需使用阿里云生成的纯字符串ID
二、确认模板审核状态
登录短信服务控制台，在「短信模板管理」页面核查：
- 模板审核状态需显示「审核通过」，未通过或审核中的模板无法使用
- 国内模板需包含工信部备案的签名，国际模板需符合目标国家法规要求
- 确保模板内容包含必要的验证码变量，例如
${code}占位符
三、检查模板与签名关联性
模板与短信签名存在强制绑定规则：
- 验证码类签名仅能发送验证码模板，通用签名支持所有模板类型
- 签名审核通过后才可关联模板，未审核签名会导致模板失效
- 国际模板需绑定国际签名，国内模板需绑定备案通过的签名
四、核对模板参数格式
通过API调试工具验证参数传递：
| 错误类型 | 解决方案 |
|---|---|
| 变量名大小写不一致 | 确保模板变量与参数JSON的key完全匹配 |
| 非必填参数未传值 | 需按模板要求填充所有变量，空值需传空字符串 |
| 参数类型不匹配 | 数字类型变量需转换为字符串格式传输 |
结论：模板ID无效问题多由配置错误引发，需按照「ID校验→审核确认→签名关联→参数验证」的排查顺序逐步处理。建议通过控制台「API调试」功能实时验证模板有效性，同时注意不同地域/版本的接口差异。
