发生了什么
换电业务里,电池是平台自己的资产。用户买一份电池套餐,就获得一段时间内使用电池的资格,电池在用户手里和换电柜之间来回流转。
套餐到期后,如果电池没有还回来,运营要安排人把它找回来。这件事在系统里落成一张找回工单,派给一线去现场处理。工单上有两处和“到期多久”有关:一块“电池归属信息”里写着套餐到期时间,一块“基本信息”里写着电池到期未归还天数。这个天数就是判断这单有多急的依据,过期越久越要先去找。
正常算法很简单:拿用户当前在用的套餐的到期日,和今天相减,得到已经过期了几天。
2 月 22 日收到的一条反馈里,一张工单不是这样。工单详情写着到期 80 多天,点进这颗电池的电池档案,同一个到期天数只有 4 天。两个页面差出两个多月,一线不知道该按哪个数判断紧急程度,只能回头找产品和研发核对。
这次看到的是一例反馈,影响多少个用户、持续了多久,记录里没有统计。
本质
问题不在减法,在于天数的基数取错了:算的时候拿的不是用户当前在用的那份套餐。
平台上的电池套餐有两种卖法:一种是换电套餐,用户到柜里把没电的电池换成满电的;另一种是租电套餐,电池随用户长期使用。两类套餐的资格记录存在不同的数据里。
- 工单详情算到期时间时,程序只到换电套餐的记录里找,而且按“最近一条失效记录”来取。
- 这位用户当前在用的是租电套餐。换电套餐这边能查到的,是一条早就失效、两个多月前就到期的记录。
- 程序把这条旧记录的到期时间当成基数,用今天减它,未归还天数就算成了 80 多天。
- 电池档案显示 4 天,这个值才对应租电套餐的到期时间。
- 同一个到期天数,两个页面各算一套:详情页的基数停在两个多月前,档案跟着当前在用的套餐走,结果就差出两个多月。工单上的到期时间和未归还天数都来自这个旧基数,所以两处一起偏。
选错了记录,算得再准也是错的。
记录给出的修复方向是:判断到期时间时把租电套餐一起考虑进来,按用户实际在用的套餐取到期时间。是否已经上线、有没有验证,记录里没有说明,这里只写方向。
下面的 Java 代码为脱敏教学示例,用于说明“取数范围漏掉一类套餐”的机制与改法,不代表实际项目源码或已上线实现。
错误代码
// 组装找回工单详情上的套餐到期时间与未归还天数(示意)
public RecoveryOrderView buildView(String userId) {
RecoveryOrderView view = new RecoveryOrderView();
// 为什么错:只到换电套餐里找,用户在用的是租电套餐,这里取不到当前那条
PackageRecord latest = packageMapper.findLatestInvalid(userId, PackageType.SWAP);
LocalDate expireDate = latest == null ? null : latest.getExpireDate();
long overdueDays = expireDate == null ? 0
: ChronoUnit.DAYS.between(expireDate, LocalDate.now());
// 基数是一条两个多月前就失效的记录,减出来的天数远大于真实值
view.setPackageExpireDate(expireDate);
view.setBatteryOverdueDays(overdueDays);
return view;
}
修复代码示例
// 换电、租电两类套餐放在同一个查询里,取用户最近生效的那一条
public RecoveryOrderView buildView(String userId) {
RecoveryOrderView view = new RecoveryOrderView();
// 为什么改:取数范围要覆盖用户可能持有的所有套餐类型
PackageRecord latest = packageMapper.findLatestByUid(
userId, List.of(PackageType.SWAP, PackageType.RENTAL));
LocalDate expireDate = latest == null ? null : latest.getExpireDate();
long overdueDays = expireDate == null || !expireDate.isBefore(LocalDate.now())
? 0 // 还没到期,不显示未归还天数
: ChronoUnit.DAYS.between(expireDate, LocalDate.now());
view.setPackageExpireDate(expireDate);
view.setBatteryOverdueDays(overdueDays);
return view;
}
电池档案也调用这同一个取数方法,两个页面才不会各算一套。PackageRecord 表示一条套餐资格记录,expireDate 是它的到期日;两类套餐记录如果分表存放,需要在查询层合并后再取最近一条,示例省略了这层实现。
下次遇到这些场景要警惕
- 新增一种套餐或售卖方式:把用到“用户当前套餐”的地方都列出来,逐条检查取数范围里有没有这种新类型,只改下单链路不够。
- 同一个指标在两个页面都出现:构造一个只在某一类套餐下的用户,两边各看一次,数字一致才算通过。
- 到期天数这类随时间变化的展示:核对基数是“当前在用的记录”还是“历史上最近的记录”,只有前者会随用户状态变化。
- 只有单条反馈、没有影响面统计时:先按套餐类型抽样比对两个页面的值,确认真实偏差范围,再定修复优先级。