发生了什么
换电业务里,用户要先用手机号登录,才能扫码从柜子里取电池。免押是登录后才会开通的一项资格:用户不用先交押金,平台确认是本人后,这个账号才能免押使用。每次登录时,系统会给用户手机发一条短信验证码,用户把收到的数字填回页面,验证通过才算登录成功。
正常流程是这样:用户从支付平台的入口选择手机号登录,系统把验证码交给短信通道发送。短信通道是替平台把短信送到手机上的第三方服务;平台只负责把内容交出去,真正发到用户手机上的是通道。几秒内用户收到短信,填入验证码,登录完成,免押资格随即可用。
这次有三位用户先后反馈:在入口里点获取验证码,手机一直收不到短信,登录走不下去,免押也就开不了。排查后确认,其中一个短信通道把发往换电业务的登录短信整条拦了下来,理由是短信模板的后缀不符合规范。模板是预先写好、只把验证码替换进去的短信正文;后缀是模板末尾固定的一段内容。通道按自己的规则审核,认为后缀不合规,就不发这批短信。后来通道侧把这条业务的发送切到另一个通道,并停止对该模板的拦截,用户才恢复收到验证码。
本质
短信不是平台自己送到手机上的。平台把内容交给第三方通道,由通道决定发不发、怎么发;通道除了转发,还会按自己的内容规范审核模板正文、末尾后缀和敏感字段。只要其中一项不符合规则,整条短信都可能被拦下。拦截发生在平台把内容交出去之后,用户侧看到的是“没收到”;如果发送侧只判断“已提交”,拦截就不会变成一条失败提示。
- 登录依赖验证码,验证码依赖短信通道,通道的内容审核实际上卡在登录的前置步骤上。通道拦一条,用户就少一步能完成的操作。
- 出问题的是模板后缀。它不是随机生成的,而是模板里固定的文案,随模板一起配置和上线,却不符合当前通道的内容规范。换通道和改模板都能改变结果,但只有改模板才是把不合规内容去掉。
- 通道把整条短信拦下后,短信没有离开通道,手机自然收不到;用户拿不到验证码,就完不成登录,免押资格也开不出来。
- 处置分两层。通道侧切换发送通道并解除对该模板的拦截,是临时恢复;把模板后缀改成合规内容、避开敏感字段,是后续要做的根治动作。记录没有写模板修改是否已经完成、是否验证过,不能当成已经修好。
- 这三起都是用户反馈后才进入排查,排查落到通道拦截上。对平台来说,短信是否真的到了用户手机,不能只看页面流程有没有走完。
短信模板是否合规由第三方通道判定,模板末尾改一段固定文案,就可能让整批验证码发不出去。
修复方向是:模板内容按每个通道的规范维护,上线前逐项核对后缀和敏感字段;发送时不要只判断内容有没有交出去,要能拿到通道的送达或拦截结果;主通道拦截时切到备用通道,并把拦截原因暴露出来。
以下两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
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");
}
}
下次遇到这些场景要警惕
- 新增或修改登录、支付这类关键短信模板时:把正文和末尾后缀逐项对照每个发送通道的内容规范,再用测试号码在目标通道实发一条,确认手机能收到,而不是只看提交接口是否返回成功。
- 一个业务接入多个短信通道时:构造主通道拒发或拦截的条件,检查系统能否自动切到备用通道,并记录切了哪个通道、切换原因是什么。
- 用户反馈收不到验证码时:按手机号和发送时间查这条短信走到了哪个通道、通道返回的是已提交还是被拦截,再区分是通道拦截、手机侧拦截还是用户填错。
- 模板上线后:对比发送量和验证成功量,某个通道的验证成功率明显低于其他通道时告警,不要等用户反馈才发现。