API 调用返回 Code 为 OK 但短信实际发送失败或未收到,如何排查?

更新时间:
复制 MD 格式

调用发送短信 API 后返回 Code: OK,仅代表该请求已成功提交至阿里云短信网关,并不代表短信已成功送达接收终端。后续的发送状态取决于运营商回执。

排查方向

  1. 检查签名状态:确认使用的签名是否在当前阿里云账号下且状态为"审核通过"。跨账号使用签名将无法发送(即账号 A 创建的签名,账号 B 无法使用)。

  2. 查看发送记录:登录短信服务控制台,在 业务统计 > 发送记录 页面,查看该条短信的运营商回执错误码,根据错误码定位具体失败原因。

  3. 报备问题:如果回执错误码指向实名制报备问题,请参考签名实名制报备相关 FAQ 处理。

  4. 终端问题:如果运营商回执显示发送成功但用户仍未收到,可能是手机终端问题(信号差、安全软件拦截、垃圾短信过滤等),请参考终端排查建议。