发生了什么
换电业务里,用户在网点的电柜前扫码,把没电的电池放进柜子,再取走一颗满电的。一个网点摆若干台电柜,每台电柜分成多个仓,一个仓放一颗电池;空着、还能再放一颗电池的仓叫空仓。网点电池不够用时,业务上要安排调入:把电池从富余的地方运到这个网点,由执行调运的人按工单操作。
工单是这次调运的凭据,一张调入工单写着一个网点要调入多少颗电池。网点有几个空仓,最多就只能再放进几颗,所以不管需求算出来是多少,实际派出去的量不能超过空仓数。
正常流程分三段:预测程序每天算出各网点对电池的需求量;数据更新后,调度决策程序按最新预测和网点电池情况,算出每个网点这一轮是调入还是调出、调入多少;结果推给建单环节,落成工单派给执行调运的人。走完一轮,一个网点手上应该只留下与它当前缺口相符的工单。
这次出问题的网点只剩 1 个空仓。当天早上数据完成更新后,有人反馈这个网点挂着 3 张调入工单。其中一张的来历是清楚的:它按前一天的数据生成,那时预测值偏大,这个网点被排进了调入名单;更新后的预测值变小,小到在决策时被过滤掉,这个网点不再需要调入。可那张已经派出去的单没有随之取消,推送环节只看本轮结果,不去查这个网点手上还有没有没执行完的旧单,旧单就一直留在网点的工单列表里。
本质
决策程序每一轮都是重新算的:它按当轮的预测值和网点电池情况给出这一轮要不要调、调多少,输出的是本轮结果,不是相对上一轮的差异。建单环节拿到结果就照着建单、派单;结果里不推荐某个网点,它就不做任何动作。问题就出在这个照着做的过程里,缺了两件事。
- 不回看这个网点已经挂着什么。已经派出去、电池还没送到、也还没取消的工单是在途工单,它送达后会占掉空仓。建单时不算在途量,等于把同一批空仓重复承诺给了多张单。
- 旧结论没有出口。新结果不再推荐这个网点调入时,建单程序只是不再建新单,并没有撤销或关闭那张按旧数据生成的单;结果里也不会出现一条明确的不调度结论,旧单就没有被关闭的入口。
两个缺口叠在一起,只剩 1 个空仓的网点,手上却压着 3 张调入工单。执行调运的人照单把电池送过去,放得进仓的最多只有 1 颗,其余的无处安放,网点现场也完不成这几张单。
每轮决策都从零重算,推送时却不与在途工单对账:旧单不回收、新单不扣减,派出去的量就会超过网点真正能接收的数量。
修复方向是:推送决策结果时增加检查项,先查该网点有没有在途工单,把在途量算作已经占用的仓位;如果这一轮决策不推荐调度,就在结果里明确给出不调度、不再留空,旧单据此取消或由人确认;本轮新单只补差额,并受空仓数约束。落到代码上,先查后插本身不是原子的,同一网点同时有多轮推送时还要靠唯一约束或互斥锁兜住,否则两次推送查到的在途量都可能是 0。
下面两段 Java 代码是按上述机制写的教学示例,只对比推送前后该检查什么,不代表实际项目源码或已上线实现。
错误代码
// 决策结果推送(脱敏教学示例)
public class InboundOrderPusher {
private final WorkOrderRepository orders;
private final Dispatcher dispatcher;
public void push(DecisionResult result) {
for (SitePlan plan : result.getSitePlans()) {
if (!plan.isNeedInbound()) {
// 为什么错:不推荐调度时直接跳过,既不回收旧单,也不告诉执行侧这批不用调
continue;
}
// 为什么错:只按本轮算出的数量建单,没有查这个网点已有的在途工单,
// 在途的调入量没有从本轮数量里扣掉
DispatchOrder order = new DispatchOrder(
plan.getSiteId(), plan.getInboundQty(), PENDING);
orders.save(order);
// 为什么错:不校验网点空仓能否容纳,直接派发
dispatcher.send(order);
}
}
}
修复代码示例
// 同一段推送逻辑:先和在途单对账,再受空仓数约束
public class InboundOrderPusher {
private final WorkOrderRepository orders;
private final SiteCapacityRepository capacity; // 网点当前空仓数
private final Dispatcher dispatcher;
public void push(DecisionResult result) {
for (SitePlan plan : result.getSitePlans()) {
// 在途量:已派出去、还没送达、也没取消的电池数
int inFlight = orders.countInFlight(plan.getSiteId());
if (!plan.isNeedInbound()) {
// 本轮不再推荐调度:给出不调度结论,旧单才有机会关掉
orders.suggestNoDispatch(plan.getSiteId(), inFlight);
continue;
}
int freeSlots = capacity.freeSlots(plan.getSiteId());
// 只补差额,且不能超过空仓数(在途电池送达后同样要占仓)
int qty = Math.min(plan.getInboundQty() - inFlight, freeSlots - inFlight);
if (qty <= 0) continue; // 在途已覆盖本轮需求,或空仓已被在途占满,不新增
DispatchOrder order = new DispatchOrder(plan.getSiteId(), qty, PENDING);
orders.save(order);
dispatcher.send(order);
}
}
}
下次遇到这些场景要警惕
- 同一个网点当天数据又更新了一次时:把更新前那轮派出的单和更新后的结果对照,看旧单是被撤销、关闭,还是仍停在待执行;只建新单不收回旧单,就会越跑越多。
- 给决策结果加补量逻辑时:构造“已有一张在途单、新预测变小”和“已有一张在途单、新预测变大”两种输入,确认前者给出不调度结论、后者只补差额,而不是按全量重新建单。
- 派单前拿容量兜底:用“空仓 1 个、建议调入 3 颗”的输入跑一遍,确认推送侧要么按容量截断,要么拦下并说明原因,而不是照单全发。
- 改完推送逻辑之后:先处理存量,把已经压着的重复单撤回或人工确认,再继续放量;只改推送代码不会让旧单自己消失。