错误码分类与含义
阿里云短信API错误码主要分为三类：签名及模板匹配问题（如isv.SMS_SIGNATURE_SCENE_ILLEGAL）、发送限制问题（如isv.DENY_IP_RANGE）和参数验证问题（如InvalidTemplateCode.Malformed）。其中签名类型与模板不匹配是高频错误，例如使用验证码类签名发送推广短信会导致请求被拦截。
| 错误码 | 触发条件 |
|---|---|
| isv.EXTEND_CODE_ERROR | 不同签名使用相同扩展码 |
| isv.DOMESTIC_NUMBER_NOT_SUPPORTED | 国际模板发送境内号码 |
通用排查流程
建议按以下顺序排查：
- 参数完整性检查：验证
SignName、TemplateCode是否与控制台配置一致 - 权限验证：确认AccessKey具备短信服务操作权限
- 网络诊断：通过
telnet检测dysmsapi.aliyuncs.com连通性 - 请求重放：使用相同RequestId测试接口幂等性
高级排查工具
阿里云提供以下技术支撑：
- 错误码诊断工具（包含错误原因和修复建议）
- 日志服务自动记录
RequestId和调用轨迹 - SDK内置异常捕获机制，支持错误类型分类
最佳实践建议
开发过程中应遵循：
- 提前完成实名制报备（需3-7个工作日）
- 对三大运营商号码进行灰度测试验证通道稳定性
- 在代码中实现错误重试机制和异常熔断策略
通过错误码分类识别核心问题，结合系统化排查流程和阿里云诊断工具，可快速解决90%以上的短信接口调用异常。建议开发者建立标准化的错误处理机制，并关注运营商政策变更。
