一、模板状态未生效
即使正确填写模板ID,若模板未通过审核或状态未同步到服务端,系统仍会提示“找不到模板”。需在阿里云控制台的短信服务-模板管理中确认模板状态为“审核通过”,且与当前应用环境匹配。
- 登录阿里云控制台,进入短信服务模块
- 选择左侧导航栏的“模板管理”
- 验证模板的审核状态和生效时间
二、区域ID配置错误
阿里云短信服务要求客户端初始化时必须指定正确的区域ID(如cn-hangzhou)。若代码中配置的区域ID与模板实际所属地域不一致,将导致端点访问失败。建议检查SDK初始化代码:
DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKey, secret);
三、签名与模板类型冲突
当验证码类签名用于发送通知或营销模板时,系统会判定为类型不匹配。需注意:
- 验证码签名仅支持发送验证码模板
- 通用签名可发送所有类型模板
- 签名和模板需在同一个阿里云账号下创建
该问题通常由多因素叠加导致,建议按顺序排查模板状态、区域配置、签名类型三个核心环节。若问题仍未解决,可通过阿里云工单系统提交完整的请求ID和错误截图。