发生了什么
换电业务里,用户在网点电柜前把没电的电池放进一个格口,再取走一颗满电的电池。电柜分成若干格口,一个格口放一颗电池,空着的格口叫空仓。网点电池不够用时,系统生成调入工单,写明从别处调几颗电池过来,由运维或调运人员按工单上的数量把电池装进空仓。
正常流程是:调度程序根据网点当前的电池数、换电需求算出这个网点要不要调入、调几颗,工单生成后数量就固定下来;执行人到了现场,按这个数量安排搬运和装柜。数量在执行过程中一般不再变化,因为人已经按它排好了动作。
这次不是。一张调入工单原本写的是2颗,运维到现场后在电柜上把一个格口置为启用,工单里的调入数量随即变成3颗。现场的空仓只放得下1颗,3颗装不进去;只装1颗,工单又完不成,完成率要受影响。执行人当场没法按单作业。
本质
问题出在“什么时候重算、重算结果写到哪里”这两件事上。
- 重算被绑在格口操作上。启用一个格口会触发调度重算,禁用格口却不触发。同样是格口状态变化,一个会改工单数量,一个不会,说明触发条件挂在了具体操作上,而不是挂在“这个网点可放电池的仓位变了”这个业务事实上。
- 重算结果直接覆盖了执行中的工单。运维在现场启用格口时,工单已经派出、人已经到场,重算却把它当成一张还没人动的单,把数量从2改成3。从结果看,重算没有把现场实际能放下的数量算进去。
- 换电这条路径也有同样的问题。用户换电会触发实时调度,系统没有为换电预留格口,工单的调度数量在执行中从1变成2。两次变化的入口不同,结果相同:已经定下来的数量被后来的事件改写了。
数量在执行中被重算改写,重算又不看现场还能放下几颗,执行人拿到的就是一张完不成的工单。
修复方向是:启用和禁用格口统一到同一个状态变更入口,按“可放电池的仓位是否真的变了”决定要不要重算;已经进入执行阶段的工单不再由重算直接改数量,重算结果与工单数量不一致时生成差异记录,交人工确认后再调整;算调入数量时把换电需要的格口预留出来,并以网点实际可放数量为上限。这次的处置是通知产品出方案完善流程,具体方案与上线状态待确认。
下面两段 Java 代码是按上述机制写的教学示例,只对比重算前后该判断什么,不代表实际项目源码或已上线实现。
错误代码
// 格口启用后的调度重算(脱敏教学示例)
public class SlotStatusHandler {
private final DispatchOrderRepository orders;
private final DispatchCalculator calculator;
public void onSlotEnabled(long siteId, long slotId) {
// 为什么错:只监听“启用”,禁用格口没有对应入口,两个方向行为不一致
int qty = calculator.calcInboundQty(siteId);
DispatchOrder order = orders.findActiveBySite(siteId);
if (order != null) {
// 为什么错:不判断工单是否已进入执行,直接把数量覆盖成重算值
order.setInboundQty(qty);
// 为什么错:重算没有为换电预留格口,也不受现场还能放几颗的约束
orders.save(order);
}
}
}
修复代码示例
// 同一段重算逻辑:启用与禁用共用入口,执行中的工单只记差异不改数量
public class SlotStatusHandler {
private final DispatchOrderRepository orders;
private final DispatchCalculator calculator;
private final SiteCapacityRepository capacity; // 网点实际可放数量
public void onSlotStatusChanged(long siteId, long slotId, boolean enabled) {
DispatchOrder order = orders.findActiveBySite(siteId);
// 换电要占一个格口,重算前先把它预留出来
int expected = calculator.calcInboundQty(siteId, capacity.swapReserve(siteId));
if (order == null) return;
if (order.isExecuting()) {
// 已派人执行:数量已和现场对齐,差异只记录,交人工确认
if (expected != order.getInboundQty()) {
orders.recordQuantityDiff(order.getId(), expected);
}
return;
}
// 未执行:按实际可放数量截断后再更新
order.setInboundQty(Math.min(expected, capacity.freeSlots(siteId)));
orders.save(order);
}
}
下次遇到这些场景要警惕
- 给设备操作加“触发重算”时:先列出所有会改变可放电池仓位状态的操作(启用、禁用、故障、恢复正常),逐个确认是否走同一个入口;只给一个方向加触发,另一个方向就会留下过期数量。
- 重算要改已经派出的工单时:用“工单已派出、人已到场”的输入跑一遍,确认数量不会被直接覆盖;执行中的单应生成差异、由人确认,而不是后台悄悄改数。
- 算调入数量时:用“网点只剩1个空仓、同时有用户要换电”的输入验证,确认预留格口和实际可放数量都参与了计算,而不是只按柜内电池数算出结果。
- 改完这类逻辑后:不要只看新生成的工单,把存量执行中的工单也一起核对,确认没有被历史重算改过的数量。