接入阿里云短信后,接口返回成功,手机却迟迟没有收到短信,开发和运营人员都可能碰到这种情况。先别连续点击发送:接口调用成功,通常只代表请求已被平台受理,不等于短信已经到达手机。问题可能出在账号配置、短信内容、发送频率、运营商网络或手机拦截设置。
先确认短信卡在哪个环节
排查阿里云短信收不到短信,先到短信服务控制台查看发送记录,核对请求时间、接收号码、签名、模板、接口返回码和发送状态。控制台页面名称可能随产品版本有所不同,以实际显示为准。根据记录,可以先判断问题大致在哪一段:
- 请求失败:检查接口参数、访问密钥、地域和服务配置,再按返回的错误信息处理。
- 请求已受理,但发送状态异常:查看失败原因,核对签名、模板和号码是否符合要求。
- 平台显示发送成功,手机没有收到:继续检查运营商下发情况、号码状态和手机拦截设置。
不要只看 HTTP 状态码就判断短信已送达。接口返回正常,和短信最终出现在用户手机上,是两个不同的环节。
阿里云短信收不到短信的常见原因
1. 签名、模板审核状态或参数不匹配
短信签名和模板需要按平台要求提交审核。调用时使用的模板编号、签名名称、变量名和变量内容,也要与已审核的配置对应。比如模板要求传入验证码和有效分钟数,代码却漏传一个变量,或变量格式不符合模板要求,请求就可能失败,短信也无法正常下发。
将控制台中的模板内容与代码逐项核对,确认没有选错模板、变量名称一致、签名已通过审核。短信正文不要自行添加模板以外的内容,也别为了试错频繁修改审核中的配置。
2. 号码格式有误,或号码无法接收短信
确认号码填写完整,没有多余空格或特殊字符;发送国际号码时,还要检查国家或地区代码是否正确。号码停机、欠费、销户,或当前处于无法接收短信的状态,也会造成收不到短信。
如果多个用户都遇到问题,优先检查短信配置和发送通道;如果只有个别号码异常,则先核实这些号码是否有效,再查看手机端的拦截设置。
3. 发送过于频繁,触发限制或拦截
验证码业务通常会限制单个号码、单个 IP 或某个业务场景的发送间隔和次数。用户连续点击发送,可能触发业务系统自己的限流,也可能受到平台或运营商的频率控制。大量重复发送,或短时间内发送内容相似的短信,也可能被识别为异常流量。
排查时先暂停连续重试,检查业务侧限流规则和发送记录,再间隔一段时间进行一次受控测试。生产环境应设置合理的发送间隔和次数上限,并为异常发送设置告警。还要检查接口超时后的重试逻辑,避免请求其实已提交,程序却继续重复发送。
4. 手机拦截、信号问题或运营商延迟
短信到达运营商网络后,可能被手机的垃圾短信过滤、陌生号码拦截或安全软件放进拦截箱。信号较弱、手机系统状态异常等情况,也可能让短信延迟显示。可以请用户检查垃圾短信和拦截记录,确认信号正常,必要时重启手机后再查看。
如果只有某个地区或某家运营商的号码异常,记录号码所属运营商、发送时间和控制台状态,方便继续核查通道情况。短信到达时间会受网络环境影响,不宜向用户承诺每条短信都能即时送达。
5. 账号、权限或资源配置不正确
确认短信服务状态正常,并检查账号是否存在欠费、额度限制或安全风控提示。如果通过 RAM 用户或应用调用短信服务,还要核实该身份具备所需权限,代码读取的访问密钥正确,且没有误用测试环境配置。
排查密钥问题时注意保护凭证。不要把完整密钥复制到工单、日志或公开渠道;整理问题信息时,应先对号码等敏感内容做脱敏处理。
案例:接口返回成功,验证码为什么没到?
某电商团队上线登录验证码后,用户反映点击发送却没有收到短信。开发人员看到接口返回正常,一度怀疑是代码问题,随后又连续重发了几次。查看发送记录后,团队发现请求已经被平台受理,但不同测试号码的结果并不一致。进一步排查发现,测试环境存在重复提交,部分号码在短时间内请求过于频繁;还有一名用户的短信被手机安全软件拦截。
团队按号码和时间整理发送记录,关闭无间隔重试,并给发送按钮增加冷却时间,同时提示用户检查拦截箱。对仍然异常的号码,再结合控制台状态和运营商信息单独核查。处理后,重复发送减少,问题也更容易定位。这个例子里,单看“接口成功”无法说明短信是否到达,需要结合平台记录、业务日志和用户反馈判断。
按固定顺序排查,减少盲目重试
- 记录发生时间、接收号码、业务场景和完整错误码;保存号码时做好脱敏。
- 查看短信发送记录,确认请求是否受理、当前状态以及是否有失败原因。
- 核对签名、模板编号、变量参数、号码格式和账号权限。
- 检查业务限流、重复提交、账号额度,再排除手机拦截和运营商网络问题。
- 用少量不同运营商的号码进行测试,对比结果,缩小排查范围。
- 仍无法定位时,整理请求时间、脱敏号码、错误码和相关记录,联系阿里云技术支持;不要提交访问密钥等敏感信息。
遇到阿里云短信收不到短信,先确认请求有没有被受理,再根据发送状态逐步检查,比反复点击发送更容易找到原因。验证码业务还应设置合理的限流和重试规则,并提示用户检查拦截箱、稍后重试或更换验证方式,避免重复请求进一步影响发送。