一、AccessKey 配置与权限问题
在调用阿里云短信接口时，AccessKey 配置错误是常见问题。需注意：
- 使用子账号 AccessKey 时，需为 RAM 用户添加 AliyunDysmsFullAccess 权限
- AccessKey Secret 仅在创建时显示，丢失后需重新生成
- 调用接口前需初始化地域 ID（如 cn-hangzhou）并验证密钥有效性
二、签名与模板审核失败
短信签名和模板审核被拒的主要原因包括：
- 签名未使用备案的企业/应用名称，个人账号无法申请企业签名
- 模板内容包含敏感词或变量格式不规范（如缺少 ${code} 占位符）
- 未通过测试模板直接提交正式审核
三、短信参数格式错误
参数传递错误会导致接口返回 InvalidParam 错误代码：
| 参数 | 要求 |
|---|---|
| PhoneNumbers | 国内号码需带 86 前缀，多个号码用英文逗号分隔 |
| TemplateParam | JSON 字符串需严格转义，如 {“code”:”123″} 需转为 \”{\\\”code\\\”:\\\”123\\\”}\” |
四、短信发送失败率高
若发送成功率低于 90%，建议检查：
- 账户余额是否充足（欠费账户会被暂停服务）
- 单次请求包含号码数是否超过 1000 个（批量发送需分批次）
- 短信内容是否包含黑名单词汇（如”贷款”、”返利”等）
五、SDK 依赖与兼容性
官方 SDK 可能出现 .NET Framework 版本冲突，替代方案包括：
- 使用 BouncyCastle 1.8.6+ 解决加密库依赖问题
- 采用精简版 HTTP 客户端实现（需自行处理 HMAC-SHA1 签名）
- 更新 NuGet 包至阿里云.SDK.SMS.v2.0.23+ 版本
结论：通过规范 AccessKey 管理、预审模板内容、验证参数格式、监控发送质量以及合理选择 SDK 版本，可解决 90% 以上的接口调用问题。建议开发阶段启用阿里云短信服务的沙箱环境进行测试。
