发生了什么

换电业务里,用户要先用手机号登录,才能扫码从柜子里取电池。免押是登录后才会开通的一项资格:用户不用先交押金,平台确认是本人后,这个账号才能免押使用。每次登录时,系统会给用户手机发一条短信验证码,用户把收到的数字填回页面,验证通过才算登录成功。

正常流程是这样:用户从支付平台的入口选择手机号登录,系统把验证码交给短信通道发送。短信通道是替平台把短信送到手机上的第三方服务;平台只负责把内容交出去,真正发到用户手机上的是通道。几秒内用户收到短信,填入验证码,登录完成,免押资格随即可用。

这次有三位用户先后反馈:在入口里点获取验证码,手机一直收不到短信,登录走不下去,免押也就开不了。排查后确认,其中一个短信通道把发往换电业务的登录短信整条拦了下来,理由是短信模板的后缀不符合规范。模板是预先写好、只把验证码替换进去的短信正文;后缀是模板末尾固定的一段内容。通道按自己的规则审核,认为后缀不合规,就不发这批短信。后来通道侧把这条业务的发送切到另一个通道,并停止对该模板的拦截,用户才恢复收到验证码。

本质

短信不是平台自己送到手机上的。平台把内容交给第三方通道,由通道决定发不发、怎么发;通道除了转发,还会按自己的内容规范审核模板正文、末尾后缀和敏感字段。只要其中一项不符合规则,整条短信都可能被拦下。拦截发生在平台把内容交出去之后,用户侧看到的是“没收到”;如果发送侧只判断“已提交”,拦截就不会变成一条失败提示。

  1. 登录依赖验证码,验证码依赖短信通道,通道的内容审核实际上卡在登录的前置步骤上。通道拦一条,用户就少一步能完成的操作。
  2. 出问题的是模板后缀。它不是随机生成的,而是模板里固定的文案,随模板一起配置和上线,却不符合当前通道的内容规范。换通道和改模板都能改变结果,但只有改模板才是把不合规内容去掉。
  3. 通道把整条短信拦下后,短信没有离开通道,手机自然收不到;用户拿不到验证码,就完不成登录,免押资格也开不出来。
  4. 处置分两层。通道侧切换发送通道并解除对该模板的拦截,是临时恢复;把模板后缀改成合规内容、避开敏感字段,是后续要做的根治动作。记录没有写模板修改是否已经完成、是否验证过,不能当成已经修好。
  5. 这三起都是用户反馈后才进入排查,排查落到通道拦截上。对平台来说,短信是否真的到了用户手机,不能只看页面流程有没有走完。

短信模板是否合规由第三方通道判定,模板末尾改一段固定文案,就可能让整批验证码发不出去。

修复方向是:模板内容按每个通道的规范维护,上线前逐项核对后缀和敏感字段;发送时不要只判断内容有没有交出去,要能拿到通道的送达或拦截结果;主通道拦截时切到备用通道,并把拦截原因暴露出来。

以下两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

public class LoginSmsService {
    private final SmsChannel channel;
    private final SmsTemplateConfig templateConfig;

    public void sendLoginCode(String phone, String code) {
        // 为什么错:后缀是模板里写死的文案,没有按当前通道的规范校验
        String suffix = templateConfig.getSuffix();
        String content = "登录验证码 " + code + "。" + suffix;
        // 为什么错:只把内容交给通道,通道按规则拦截后这里拿不到提示
        SendResult result = channel.send(phone, content);
        if (result.isAccepted()) {
            log.info("login sms submitted");
        }
    }
}

修复代码示例

public class LoginSmsService {
    private final List<SmsChannel> channels;

    public void sendLoginCode(String phone, String code) {
        for (SmsChannel channel : channels) {
            // 修复:后缀随通道已审核的模板一起下发,不再自由拼接
            SmsTemplate template = channel.approvedTemplate("LOGIN_CODE");
            if (template == null) {
                continue; // 该通道没有可用模板,换下一个
            }
            SendResult result = channel.send(phone, template.render(code));
            // 修复:确认送达才算发送成功,被拦截时换备用通道
            if (result.isAccepted() && channel.isDelivered(result.getMessageId())) {
                return;
            }
            log.warn("login sms blocked or undelivered, channel={}", channel.name());
        }
        throw new SmsNotDeliveredException("login code not delivered");
    }
}

下次遇到这些场景要警惕

  1. 新增或修改登录、支付这类关键短信模板时:把正文和末尾后缀逐项对照每个发送通道的内容规范,再用测试号码在目标通道实发一条,确认手机能收到,而不是只看提交接口是否返回成功。
  2. 一个业务接入多个短信通道时:构造主通道拒发或拦截的条件,检查系统能否自动切到备用通道,并记录切了哪个通道、切换原因是什么。
  3. 用户反馈收不到验证码时:按手机号和发送时间查这条短信走到了哪个通道、通道返回的是已提交还是被拦截,再区分是通道拦截、手机侧拦截还是用户填错。
  4. 模板上线后:对比发送量和验证成功量,某个通道的验证成功率明显低于其他通道时告警,不要等用户反馈才发现。