发生了什么
换电业务里,电池是可以在柜子里循环使用的实物资产。用户把手上快没电的电池放进柜子,再从柜子取走一块满电的电池,全程不需要人值守。每块电池在系统里有一份档案和一套状态,能不能放给用户取,就看这套状态。
电池出故障时,系统或运维会在工单里记一张故障工单。这张工单有两个作用:一是处理凭据,运维按它到柜前把电池取出来送修;二是这块电池不能给用户用的依据。按正常流程,故障工单建立后电池会被置为故障,锁在柜内不再放给用户取用,业务上把这叫锁仓;等电池修好、故障工单关闭,才恢复可用、重新投放。
正常的顺序是:电池被判定故障,建故障工单并锁仓;运维按工单把电池取出来送修;修好后在故障工单上登记处理结果、把工单关闭;电池恢复可用。这条顺序里,关闭工单是电池回到用户手里的前提。
这次不是走完这条顺序。这块电池最后是从另一类工单里取出来的:有一类工单只负责把电池从柜里取走,与故障处理无关。取出这一步本身是成功的,电池离开了柜子,之后照常在用户之间流转,看不出被锁住的样子。但原先那张故障工单没有被取消,一直挂在未关闭状态。
于是同一块电池上出现了两条互相矛盾的记录:工单这一侧显示它还有一张没关的故障工单,看起来故障一直没处理;电池这一侧显示它正常参与换电,用户照常取用。反馈的人看到的正是这个现象——一直有故障工单,电池却在用户手里正常流转,所以来问这块电池到底有没有被锁仓。
本质
一句话:故障工单只能由它自己的处理流程关闭,从别的工单把电池取走这条路径不查、也不会去关它,于是电池已经回到正常流转,工单还挂在那里。
拆开看:
- 故障工单要关闭,靠的是它自己的收尾动作。运维在故障工单上登记处理结果,工单状态才走到关闭;没有这一步,这张工单就一直停在未关闭,放多久都一样。
- 取出是另一类工单,它只做自己的事:确认电池从柜里取下、把电池的可用状态改掉、完结自己。它不会回头去看这块电池身上还有没有别的未关闭工单。这条取出路径在最初实现时就没有「同时取消同一块电池的故障工单」这一步,后来也没有补上,属于一直沿用下来的历史逻辑。
- 两条路径各自改了一半,中间没有人对齐:电池的可用状态被取出流程改成了正常,故障工单仍停在自己的未关闭状态,系统里没有任何一处会再把两者拉回来。电池后来为什么又能正常换电,材料里没有能对上的一步,能确认的是那张故障工单始终没有被关闭。
- 所以反馈人看到的是有故障工单、电池却正常流转。只按工单判断,会以为这块电池还没处理;只按电池判断,会以为它从来没坏过。两条记录谁都不算写错,放在一起就是矛盾的。
故障工单由它自己的流程关闭,电池的可用状态却可以被别的工单改掉;两条路径各改一半,就留下一块带着未关闭故障工单、却照常给用户用的电池。
记录给出的处置是提需求修复,方向是让取出这类操作在收尾时一并处理同一块电池上未关闭的故障工单,计划在 7 月中旬上线。有没有按期上线、上线后是否验证,记录里没有写明,所以这里说的是修复方向,不是已经生效的结果。
错误代码
取出工单收尾时,代码只改了自己的状态和电池的可用状态,没有回查故障工单:
public void finishRetrieve(String orderNo, String batteryNo) {
RetrieveOrder order = retrieveOrderMapper.selectByNo(orderNo);
// 取出成功,电池离开柜子,回到可用状态
batteryMapper.updateStatus(batteryNo, BatteryStatus.AVAILABLE);
order.setStatus(OrderStatus.FINISHED);
order.setFinishTime(new Date());
retrieveOrderMapper.updateStatus(order);
// 为什么错:到这里取出流程就结束了,没有回查这块电池上
// 是否还挂着未关闭的故障工单;而故障工单只在它自己的
// “维修完成”动作里关闭,走这条路取出的电池就一直带着一张未关闭的故障工单
}
修复代码示例
修复沿用同一个入口:电池可用状态照旧更新,但收尾时把同一块电池上未关闭的故障工单一并收口,并且只在确认故障已处理时才关闭。
public void finishRetrieve(String orderNo, String batteryNo) {
RetrieveOrder order = retrieveOrderMapper.selectByNo(orderNo);
batteryMapper.updateStatus(batteryNo, BatteryStatus.AVAILABLE);
order.setStatus(OrderStatus.FINISHED);
order.setFinishTime(new Date());
retrieveOrderMapper.updateStatus(order);
// 修复:取出收尾时,把同一块电池上未关闭的故障工单一并收口
boolean faultFixed = order.getInspectResult() == InspectResult.NO_FAULT;
for (FaultOrder fault : faultOrderMapper.selectOpenByBattery(batteryNo)) {
if (!faultFixed) {
continue; // 电池仍有故障:工单保留,继续锁仓
}
// 只在工单仍未关闭时关闭,避免覆盖别人刚提交的维修结果
faultOrderMapper.closeIfOpen(fault.getOrderNo(), CloseSource.RETRIEVE_ORDER, orderNo);
}
}
下次遇到这些场景要警惕
- 给电池增加一种能改变它可用状态的操作(取出、调入、调出、报废)时,先列清楚同一块电池上还有哪些状态必须跟着变,再完整跑一遍这条流程,检查操作结束后这块电池上是否还挂着其他类型未关闭的工单。
- 遇到一直有故障工单、电池却在流转的反馈,不要只看工单状态:按电池把最近一段时间的工单按时间排开,找出电池最后一次离开故障状态是由哪张工单完成的,那张工单就是漏了收口的地方。
- 给工单加自动取消时,一定要构造取出时电池确实还有故障的场景:取消只能发生在故障已处理的情况下,否则会把真实故障连着工单一起关掉,电池带着毛病回到用户手里。
- 处理存量时按电池维度查,不要按工单维度查:一块电池上应当只剩它当前真实需要的工单,多余的要清掉,并记下是谁、因为哪张工单清掉的,便于事后追溯。