模板ID配置错误
阿里云短信服务要求模板ID必须同时满足以下条件才能正常调用:
- 在代码中填写的模板ID需与阿里云控制台创建的模板完全一致
- 短信签名和模板需属于同一阿里云账号
- 消息管理后台需同步更新模板ID
模板审核未通过
阿里云对短信模板实施强制审核机制,出现「找不到模板」提示时需检查:
- 登录控制台查看模板审批状态
- 确认模板内容符合短信规范
- 重新提交未通过审核的模板
账号权限或AccessKey问题
调用接口时需注意权限配置:
- 确认使用的AccessKey与模板所属账号匹配
- 检查RAM子账号是否被授予Dysmsapi权限
- 验证AccessKeySecret是否正确
缓存或配置延迟
新创建模板后可能出现2-5分钟延迟,建议:
- 等待5分钟后重试
- 清除本地SDK缓存
- 重启应用程序服务
常见问题对照表
现象 | 检查项 |
---|---|
接口返回TemplateDoesNotExist | 模板ID大小写校验 |
控制台显示审核通过但调用失败 | 地域一致性检查 |
阿里云短信模板提示「找不到」主要涉及ID配置、审核状态、账号权限三大核心环节。建议开发者遵循官方文档进行全链路排查,特别注意模板创建后需等待审核通过并完成AccessKey授权。