配置信息错误
最常见的配置错误包括：
- AccessKey ID/Secret未正确填写或已过期
- 短信签名与模板未在控制台完成绑定
- 区域节点(endpoint)选择错误
解决方案建议通过控制台重新核对配置参数，确保签名、模板CODE、API密钥等信息完全匹配。
权限不足导致调用失败
主要涉及RAM子账号权限问题：
- 未授予AliyunDysmsFullAccess策略
- 主账号未完成企业实名认证
- AccessKey未绑定短信服务
需在RAM控制台为子账号添加短信服务全量权限，并确保主账号已完成企业级实名认证。
签名/模板审核未通过
审核失败常见原因包括：
- 签名与营业执照名称不一致
- 模板包含敏感词汇或变量格式错误
- 未上传有效的资质证明文件
建议参考控制台审核指引准备材料，验证码类模板变量需使用${code}标准格式。
网络连接异常
可能存在的网络问题：
- 服务器未开通公网访问权限
- 安全组限制短信服务端口
- DNS解析失败导致API地址不可达
可通过telnet测试dysmsapi.aliyuncs.com:80端口连通性，或使用VPC专用网络连接。
API调用参数错误
常见调用异常包含：
- 手机号格式未包含国际区号
- 模板变量JSON格式不规范
- 请求频率超过账户级限流
建议使用官方SDK进行参数校验，调试阶段可开启请求日志追踪。
阿里云短信服务的配置需严格遵循官方文档要求，重点注意账号权限、网络连通性和内容审核规范。建议通过控制台自带的调试工具逐步验证配置有效性，正式调用前务必完成沙箱环境测试。
