发生了什么
换电业务里的电池,交付给用户有两种方式,规则完全不同。一种是租电:用户按期租用,到期把电池还回来或者续租,所以到期这件事必须有人处理。另一种是售电:用户一次性买断,电池归用户所有,到期不再回收,也就不需要派人处理。系统里有一个到期工单程序,它按每颗电池的到期时间判断哪些电池到期了,判成需要处理的就生成一张到期工单,派给一线。这张工单就是“哪颗电池到期了、需要谁去做什么”的记录。
正常流程因此分成两条:租电的电池到期,程序判成需要处理,生成工单;售电的电池到期,在判断阶段就被过滤掉,不生成工单。要过滤售电,程序得先认出“这块电池是卖出去的”。而售电还按卖出的渠道分成几类:电池业务直接卖的、另一个合作项目卖的、随整车一起卖给用户的。同一个“售电”,在系统里是不同的渠道取值。
这次上线的是“租电也要派发工单”的改动。按产品需求,原来租电和售电都不派单,现在改成只过滤售电、租电恢复派单。改动之后,过滤售电从“顺手挡一下”变成了唯一的闸门:只要售电漏过过滤,就会直接生成工单。过滤条件按销售渠道逐项列举,当时覆盖了电池业务售卖和合作项目售卖两类,随整车售卖的电池没有列进去。
结果是,随整车卖出去的电池到期后照常被程序判成需要处理,建单、派给一线。上线后出现了多张这样的工单,用户已经买断的电池被当成需要处理的对象。同期还有反馈说,工单上显示的到期天数与用户实际到期时间对不上:当天到期的用户,工单里显示已到期二十多天。这个天数按哪个日期计算,记录里没有说明,这里只把它当作看到的另一个现象。
本质
问题出在“要不要为这颗电池建单”的判断条件上:程序按销售渠道列举了哪些售电不派单,而不是按“售电”这件事本身判断。
- 判断入口:到期工单程序按电池的到期时间选出已经到期的电池,这一步不区分租电还是售电。
- 判断要不要派单:对每颗电池先看交付方式是不是售电;如果是售电,再拿它的销售渠道去查“不派单名单”。
- 名单漏项:名单是代码里写死的两个渠道取值。随整车售卖是另一条渠道,它同样属于售电,但不在名单里,第 2 步查询的结果就是“不在名单中”。
- 继续建单:判断因此认为这颗电池需要处理,走建单逻辑,生成到期工单并派给一线。
- 结果:售电的电池和租电的电池走了同一条路。这类电池的数量随整车销量增长,每颗到期都会再产生一张工单。
用“销售渠道枚举”来表达“售电不派单”,只要新增一条卖电池的渠道而名单没有同步,新渠道的售电就会被当成需要派单的电池。
修复方向是把判断依据从渠道枚举换成交付方式本身:售电的电池一律不建单,不管从哪个渠道卖出;租电才继续按到期时间判断。如果短期只能先补名单,也要把“新增销售渠道时必须回头改这份名单”写成明确动作,否则下一次加渠道还会重演。记录里只写了处理完成,没有写具体改法和回归结果,这里不声称已经验证。
下面的 Java 代码是按上述机制写的教学示例,用于对比“按渠道列举”和“按交付方式判断”两种写法,不代表实际项目源码或已上线实现。
错误代码
// 到期工单:判断一颗电池到期后要不要建单(教学示意)
public class ExpireOrderService {
// 不派单的渠道:按销售渠道逐个列举
private static final Set<SaleChannel> NO_ORDER_CHANNELS = Set.of(
SaleChannel.BATTERY_BIZ, // 电池业务直接售卖
SaleChannel.PARTNER_PROJECT); // 另一个合作项目售卖
public void handleExpire(BatteryPack pack, LocalDateTime now) {
// 为什么错:售电的过滤依赖这份渠道名单,
// 随整车售卖的渠道不在名单里,这里不会返回
if (pack.getSaleType() == SaleType.SALE
&& NO_ORDER_CHANNELS.contains(pack.getSaleChannel())) {
return;
}
if (!pack.getExpireTime().isAfter(now)) {
// 售电电池到期不该建单,这里却建了
createExpireOrder(pack);
}
}
private void createExpireOrder(BatteryPack pack) { /* 建单细节省略 */ }
}
修复代码示例
// 同一处判断:先按交付方式分流,售电一律不建单
public class ExpireOrderService {
public void handleExpire(BatteryPack pack, LocalDateTime now) {
// 修复:售电=用户买断、到期不回收,
// 与从哪个渠道卖出无关,不再逐项列举渠道
if (pack.getSaleType() == SaleType.SALE) {
return;
}
// 只有租电才按到期时间判断
if (!pack.getExpireTime().isAfter(now)) {
createExpireOrder(pack);
}
}
private void createExpireOrder(BatteryPack pack) { /* 建单细节省略 */ }
}
下次遇到这些场景要警惕
- 给某类对象写“不建单、不派单”的过滤条件时:先确认判定依据是对象本身的属性还是它的来源。用属性(这里就是租电或售电)判定,不要按来源渠道列举;列举意味着每加一个渠道都要改一次代码。
- 上线“某类对象恢复派单”的改动时:把另一类对象仍要过滤的条件完整读一遍,列出它依赖的所有维度(渠道、套餐类型、来源、状态),再对照本次需求提到的对象,确认旧条件是否已经覆盖。
- 这类工单规则上线第一天:把新规则下的建单结果按交付方式和渠道分组统计,和历史过滤结果做对比;售电分组出现非零的建单数,就说明过滤名单有漏项,不用等业务反馈。
- 看到工单上的到期天数明显不对时:先确认建单用的是哪个时间字段,再判断是过滤问题还是取数问题,不要用同一个原因解释两个现象。