发生了什么
换电业务里,电池是平台自己持有的资产。用户买的是电池套餐,一段期限内可以到换电柜把没电的电池换成满电的,电池就在用户手里和柜子里来回流转。套餐到期后,电池如果已经还回柜子,这次租用就结束;如果还在用户手上,运营要安排人把它找回来。
找回这件事在系统里落成一张工单,派给一线,一线去现场处理。工单上挂着一组标签,写明这是哪一类单,比如到期类的单会按电池到期多久分档;一线在工单列表里看到的单据类型和优先级,就是这些标签。正常流程是:系统识别到需要处置的事件,先确认这颗电池此刻不在柜里——电池已经在柜,就不需要再派人去找——再按事件类型套对应模版生成工单、派单。
这次不一样。5月30日下午,系统识别到一条在柜场景的异常事件,按这条事件生成了一张工单;同时工单模版配置出了问题,把到期工单的标签关联到了这类事件的工单上。一线在工单列表里看到的就是:电池明明在柜里,却派来一张挂着到期标签的单,于是到工单群里问“在柜怎么会直接派到期”。
影响范围记录里没有统计,能看到的是这一条反馈。电池就在柜里,这张单派下去也没有可找回的对象。
本质
问题不在标签的写法,而在建单和挂标签这两步各自少了一道约束,叠在一起就成了“在柜的电池被派了一张到期单”。
- 建单程序是被事件驱动的:收到事件后按事件类型取模版、建工单、派单,中间没有查这颗电池此刻在哪里。电池在柜,说明它不用再被找回,本来不该生成找回动作;但生成条件里没有“在柜就跳过”这一条,所以在柜的电池也能建出工单。记录还指出,生成找回工单的入口同样缺这条校验,电池在柜一样能生成找回单。
- 工单显示成什么类型,由建单时套用的模版决定:模版带一组标签,标签直接写进工单,页面和派单列表照着显示。这次模版把到期工单的标签组关联给了在柜事件对应的工单类型,工单从建出来就带着“到期”身份,跟它实际是哪一类单没有关系。
- 两处缺陷的分工很清楚:缺校验决定这张单根本不该存在,标签挂错决定它看起来是一张到期单。一线按标签理解业务,看到在柜的电池挂着到期单,只能判定系统出错,再回头找人核对。
在柜状态是建单前必须判断的业务条件,标签是工单对外的业务身份,两者都不该走默认路径。
处置情况:模版标签的关联已经改了,记录标注6月8日修复;“生成前先校验电池是否在柜”这条,记录写的是反馈产品、后期优化逻辑,没有写是否上线、是否验证。这类单之后还会不会再生成,取决于这条校验有没有真正落地。
下面的 Java 代码为脱敏教学示例,用于说明“建单不校验在柜状态、标签照抄模版”的机制与改法,不代表实际项目源码或已上线实现。
错误代码
// 事件触发生成工单(示意):事件类型选模版,模版带标签,建完直接派单
public void onEventDetected(BatteryEvent event) {
Battery battery = batteryRepo.get(event.getBatteryNo());
// 为什么错:没有先判断电池是否已经在柜,在柜也照样往下建单
WorkOrderTemplate tpl = templateRepo.getByEventType(event.getType());
WorkOrder order = new WorkOrder();
order.setBatteryNo(battery.getNo());
order.setOrderType(tpl.getOrderType());
// 为什么错:标签整组照抄模版,这条模版误挂了到期工单的标签
order.setLabels(tpl.getLabels());
order.setStatus(WAIT_DISPATCH);
orderMapper.insert(order);
dispatch(order); // 建完即派给一线,问题到派单列表里才暴露
}
// 模版配置(示意):IN_CABIN 事件被关联到 EXPIRY 的标签组
修复代码示例
public void onEventDetected(BatteryEvent event) {
Battery battery = batteryRepo.get(event.getBatteryNo());
// 改:建单前先看当前状态,在柜说明不用再找回,不再生成工单
if (battery.isInCabinet()) {
log.info("skip order, battery in cabinet, no={}", battery.getNo());
return;
}
WorkOrderTemplate tpl = templateRepo.getByEventType(event.getType());
// 改:标签按事件类型算出应有的一组,与模版比对,不一致直接报错
Set<String> expected = labelRule.labelsOf(event.getType());
if (!expected.equals(new HashSet<>(tpl.getLabels()))) {
throw new IllegalStateException("template label mismatch, tpl=" + tpl.getId());
}
WorkOrder order = new WorkOrder();
order.setBatteryNo(battery.getNo());
order.setOrderType(tpl.getOrderType());
order.setLabels(tpl.getLabels());
order.setStatus(WAIT_DISPATCH);
orderMapper.insert(order);
dispatch(order);
}
下次遇到这些场景要警惕
- 新增或调整“事件触发生成工单”的规则时:把事件的触发条件和建单的前置条件分别列成清单,再构造“资产已经回到柜里”“已经处理完”这类状态跑一遍,确认既不建单也不派单,观察工单表里没有新增记录。
- 工单类型、标签、优先级由模版或配置决定时:为每个事件类型写一份期望标签集,建单后用事件类型反查工单标签是否一致;改模版配置时,把所有引用该模版的事件类型各生成一单,看列表里显示的单据类型是否都为预期。
- 排查“状态互相矛盾的单”:如电池在柜却派了找回单、电池已还却还在催办,先查这张单由哪个事件、哪套模版生成,再核对建单时刻资产的在柜状态,不要一上来就怀疑标签算法或数据源。
- 标签挂错修好之后:把同一时间段已经派出去的存量单一起拉出来,确认标签已纠正或工单已撤回;只改配置不回查,一线手里的旧单仍按错的类型处理。同时留意校验与建单之间的窗口——电池可能在两步之间被取出或放入,必要时按当前状态做条件写入或事后对账。