短信发送失败时，先不要只看“用户没收到”。需要按提交、发送、接收三个阶段排查：接口是否提交成功，发送记录是什么状态，状态报告或失败原因指向哪里。
先分类
| 问题阶段 | 判断方式 | 下一步 |
|---|
| 接口未提交成功 | API 返回错误码或控制台无记录。 | 检查参数、账号、密钥、余额。 |
| 提交成功但发送失败 | 发送记录显示失败或状态报告返回失败。 | 查看失败原因、签名模板、号码和内容。 |
| 发送成功但未收到 | 记录显示成功，用户手机无短信。 | 排查终端拦截、号码状态、延迟和频控。 |
| 批量部分失败 | 同批次中部分号码失败。 | 检查号码质量、内容审核和通道状态。 |
排查清单
| 检查项 | 怎么查 | 常见处理 |
|---|
| 错误码 | 查看接口返回码或失败状态。 | 对照错误码说明修正参数或配置。 |
| 发送记录 | 按手机号、时间和状态查询记录。 | 确认提交状态和失败原因。 |
| 签名模板 | 确认签名、模板、变量和报备状态。 | 调整内容或补充报备材料。 |
| 余额费用 | 查看余额、套餐和计费状态。 | 充值或确认套餐可用范围。 |
| 手机号 | 确认号码格式、运营商、停机欠费和黑名单。 | 更换号码交叉测试。 |
| 内容审核 | 检查敏感词、营销退订和发送时间。 | 调整文案并重新测试。 |
发送记录怎么看
- 没有发送记录，通常优先回到接口请求或控制台提交动作排查。
- 有记录但状态失败，优先查看失败原因、错误码和模板内容。
- 记录成功但用户未收到，优先查看终端拦截、号码状态和验证码收不到排查。
- 批量发送异常时，记录失败号码比例、发送时间、内容和号码来源。
联系支持前准备
| 需要提供 | 说明 |
|---|
| 发送时间 | 精确到大致时间段，便于定位记录。 |
| 手机号脱敏信息 | 保护隐私，同时便于查询。 |
| 短信签名和模板 | 用于确认报备和内容审核。 |
| 错误码或失败状态 | 用于判断问题类型。 |
| 业务场景 | 验证码、通知、营销或国际短信要分清。 |
