发生了什么
平台有一类“免时长”权益:在约定期限内使用服务不单独计费。系统会给每个用户存一条免时长记录,记录里既有不会变的用户编号,也有登记时的手机号。代客户下单时,订单程序创建订单后,要先按用户找到这条免时长记录,再把这次下单对应的免时长开通到用户名下;开通成功后,订单进入正常使用状态。
正常一笔代下单,程序拿用户资料里的用户编号和手机号去查免时长记录。查到记录后调用开通逻辑,订单保持有效,客户马上能用上这段免费时间。免时长挂在用户名下,和订单是两样东西:订单记录这次下单,免时长记录客户实际能用多久。
这次,操作人员替一位客户下了一笔单。客户不久前换过手机号。用户资料里的手机号已经改成新号,免时长记录里存的还是旧号。下单时程序仍然拿“用户编号 + 当前手机号”两个条件一起查,旧记录上的手机号对不上新号,查询返回空。后面的开通逻辑没有拿到记录,也就没有执行开通。订单生成后很快显示已结束,客户没有拿到免时长。问题出现后,只能由值班人员按临时流程手工补处理。
本质
一句话:查询把手机号也当成了匹配条件,而手机号是用户会改的资料;免时长记录里留的是旧号,用户换号后,记录还在,用新号却查不到,开通逻辑把“查不到”当成“没有”,订单最后以结束收场。
拆开看:
- 免时长记录和用户资料各存了一份手机号。用户编号不变,手机号会变;用户换号后,两份数据就不一致了。
- 这次换号只更新了用户资料,没有同步到免时长记录。记录里的旧号成了过期副本,但记录本身没有丢。
- 下单查询用“用户编号 + 当前手机号”。编号对得上、手机号对不上,数据库返回 0 行;如果只按用户编号查,这条记录本来能查到。
- 后续处理把 0 行当成“这个用户没有免时长”,开通逻辑没有执行,订单最后被置为结束。查询条件和业务判断就这样连在了一起:一个会变的资料字段,决定了权益能不能开通。
- 最终订单显示已结束,客户没有免时长,只能人工补。
记录还在,但用新手机号永远查不到,空结果被当成“没有”,开通就被跳过了。
修复方向是:查免时长只按不会变的用户编号,手机号不参与匹配;如果手机号必须留在记录里,就在换号时同步更新这份副本,或者不存。查询为空时要和“有记录但条件没匹配上”分开处理,不能静默结束订单,至少留下可排查的上下文。长期方案是下个迭代由产品出方案,短期仍由值班人员手工处理,因此这次没有可确认的代码修复上线。
下面两段代码是按这条查询链路写的脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名和字段名均为示意。
错误代码
public void openFreeDuration(Order order) {
User user = userService.get(order.getUserId());
// 为什么错:手机号是用户可改的资料,免时长记录存的是开通时的旧号;
// 换号后拿新号一起查,记录还在也匹配不上
FreeDuration record = freeDurationMapper.selectByUidAndPhone(
user.getUid(), user.getPhone());
if (record == null) {
// 为什么错:把“条件没匹配上”当成“没有免时长”,
// 开通逻辑一步都没执行,后续把订单置为结束
orderService.finish(order.getId());
return;
}
freeDurationService.activate(record, order);
orderService.activate(order.getId());
}
修复代码示例
@Transactional
public void openFreeDuration(Order order) {
User user = userService.get(order.getUserId());
// 只按不会变的用户编号查,手机号不参与匹配
FreeDuration record = freeDurationMapper.selectByUid(user.getUid());
if (record == null) {
// 确实没有记录时明确失败,交给人工或补发流程,不静默结束订单
throw new BizException("用户没有免时长记录,订单不能直接结束");
}
if (!user.getPhone().equals(record.getPhone())) {
// 手机号只是历史快照,发现不一致就更新,不影响本次开通
freeDurationMapper.updatePhone(record.getId(), user.getPhone());
}
freeDurationService.activate(record, order);
orderService.activate(order.getId());
}
事务只覆盖本地写入;如果开通还要调用外部服务,需要补偿或幂等,不能只靠回滚。
下次遇到这些场景要警惕
- 给用户查权益、额度或订单时,把查询条件逐项过一遍:手机号、证件号、昵称这类会变的字段,能不能换成用户编号;如果必须保留,先确认改号流程会同步更新所有副本。
- 构造“换号后下单”的回归数据:先给用户建免时长记录,再改用户资料里的手机号,然后代下单;检查记录是否仍能查到、免时长是否开通、订单状态是否正常,不要只看下单接口返回成功。
- 对“查不到”做区分:同一批用户分别按用户编号、按“编号 + 手机号”各查一次,数量不一致时打印差异并告警,确认是条件问题还是确实没有记录。
- 上线前核对存量:统计免时长表手机号与用户资料手机号不一致的记录,评估影响范围;换号入口也要检查是否还有别的表留了旧号。