发生了什么

换电业务里,用户在网点的电柜前把没电的电池放进仓格,再取走一颗满电的。一台电柜分成若干仓格,一个仓格放一颗电池。网点某类电池不够用时,系统生成调入工单,写明从别处调几颗过来,由调运或运维按单把电池装进空仓。工单上的“请求调度数量”,就是这张单要求调入的颗数。

这个数不是实时读出来的,而是在几个时点重算后写进工单。每天固定时段,预测程序把每个网点各类电池的需求量推下来,调度按“需求量减柜内已有电池数”算出还缺几颗,落成工单;之后遇到会改变柜内电池数的事件,再触发一次重算,覆盖工单上的数量。

这次,某类电池当天推送下来的需求量是 5 颗,工单上先写的请求调度数量是 1 颗,也就是按当时的柜内电池数只缺 1 颗。上午十点左右,维修人员到现场开柜检修。开柜触发了一次工单重算,请求调度数量从 1 颗变成 5 颗,正好等于整个类目的需求量。维修关柜后,关柜事件没有触发重算,数量就停在 5 颗。

反馈的人到现场看到的是:柜内已经放了 8 颗电池,工单还要调入 5 颗。

本质

一句话:工单数量只在开柜这次事件上重算,那次重算又没有把柜内已有电池从缺口里扣掉,关柜之后不再重算,数量就一直停在 5 颗。

  1. 原流程。需求量 5 颗,柜内已有电池若干,调度算出的缺口是 1 颗,工单写 1 颗,执行人按单送 1 颗就够。
  2. 开柜触发的重算改了数量,写入的却是整份类目需求。从 5 这个数看,柜内已有的电池没有参与计算:缺口本该是“需求减柜内”,这次只取了需求那一头。
  3. 关柜事件不在触发清单里。柜门关了,柜内电池数已经变了,工单数量却没有跟着重算,于是停在开柜那一刻写下的 5 颗。
  4. 纠正要等下一次换电。只有用户来取电,工单才会再次重算。数量能不能追上实际库存,取决于下一个用户什么时候来换电。

结果就是工单指的方向和现场相反:柜里放得越多,工单还要求继续调入。按单执行会多送电池、多占运力,现场也可能因为放不下而完不成工单。

修复方向是:把开柜、关柜、换电、电池进出仓这些会改变柜内可计入电池数的动作,统一接到同一个重算入口;重算固定按“类目需求减柜内可计入电池数”求缺口;开柜时柜内电池被解除占用,算出的库存不代表关柜后的状态,重算应等到关柜后再做,不要用开柜时点的数据覆盖工单;重算结果与工单现有数量相同就不写。记录里给的处置是等实时调度上线后补充实时更新的触发场景,并由产品提需求优化更新逻辑,方案与上线状态待确认。

下面两段 Java 代码是按上述机制写的脱敏教学示例,只对比重算的时机与口径,不代表实际项目源码或已上线实现。

错误代码

// 开柜、关柜两件事的处理(脱敏教学示例)
public class DispatchOrderService {

    private final DispatchOrderRepository orderRepo;
    private final DemandService demandService;

    public void onCabinetOpened(long siteId) {
        SiteDemand demand = demandService.current(siteId);   // 该类目需求量 5 颗
        DispatchOrder order = orderRepo.findActiveBySite(siteId);
        // 为什么错:开柜时柜内电池刚被解除占用,库存状态还没稳定就重算
        // 为什么错:直接拿整份需求覆盖数量,没有减掉柜内已有电池
        order.setRequestQty(demand.getQty());
        orderRepo.save(order);
    }

    public void onCabinetClosed(long siteId) {
        // 为什么错:关柜后柜内电池数已变化,这里不做重算,工单停在上一次的数量
        log.info("cabinet closed, site={}", siteId);
    }
}

修复代码示例

// 同一个入口:柜门开合、换电、电池进出仓都走这里重算(脱敏教学示例)
public class DispatchOrderService {

    private final DispatchOrderRepository orderRepo;
    private final DemandService demandService;
    private final BatteryRepository batteryRepo;

    public void onInventoryChanged(long siteId, InventoryChange change) {
        // 修复:开柜期间柜内电池处于解除占用状态,等关柜或电池真正进出仓后再算
        if (change.isDoorOpen()) {
            return;
        }
        SiteDemand demand = demandService.current(siteId);
        int inCabinet = batteryRepo.countCountable(siteId);   // 柜内可计入的电池数
        int gap = Math.max(demand.getQty() - inCabinet, 0);   // 缺口才是调入量
        DispatchOrder order = orderRepo.findActiveBySite(siteId);
        if (order == null || order.getRequestQty() == gap) {
            return;   // 数量没变化不写,避免无意义覆盖
        }
        order.setRequestQty(gap);
        orderRepo.save(order);
    }
}

下次遇到这些场景要警惕

  • 给工单数量加重算触发时:先列出所有会改变柜内电池数的事件(开柜、关柜、换电、电池进出仓、维修放取电池),逐个确认是否走同一个入口;只挂一个方向,另一个方向就会把旧数量留在工单上。
  • 重算结果要覆盖工单数量时:用“柜内已有 8 颗、需求 5 颗”的输入跑一遍,确认算出的缺口是 0 而不是 5;再拿数量与柜内实际、工单明细对一遍,看工单指向的是调入还是调出。
  • 要在设备门开合期间做库存计算时:先确认这个时点的库存状态是否可信;不可信就把重算推迟到关柜之后,不要用开门那一刻的数覆盖工单。
  • 改动上线后验证时:不要只看新生成的工单,把已经挂着的老工单按柜内实际电池数逐张核对,确认没有停在错误数量上。