发生了什么

换电业务里,电柜被投放在网点,柜内按格口放电池,用户扫码把没电的电池换成满电的。一个网点通常不止一台柜子,柜子多、电池少的时候,平台不会让每个空格口一直空着,而是把别处的电池调过来补——这件事落成一张“电池调入工单”,写明往哪台柜子调、调几颗,由一线按单把电池搬过去放进格口。

正常流程是:补电池的调度规则按网点找出还缺电池的柜子,先确认这台柜子当前可以收电池,也就是在线、正常对外服务,再按空格口数量生成调入工单。离线、待整改、停用这类柜子不该收电池:它本来就不对外服务,电池搬过去用不上,柜子还在整改,搬进去反而妨碍现场处理。

这次反馈的是同网点下一台处于“离线待整改”状态的柜子:名下没有电柜离线工单,柜内还有空格口,系统就给它生成了电池调入工单。柜子本身已经不在对外服务的状态,工单却按正常补货生成出来了。记录里只写了这一条,没有统计同类柜子有多少;处置是先取消这张工单。

本质

一句话:判断“这台柜子能不能收电池”时,程序查的不是柜子自己的服务状态,而是它名下有没有一张电柜离线工单;这台柜子离线待整改却没有离线工单,于是被当成正常柜子放行。

  1. 补电池的规则要回答两件事:这台柜子还缺不缺电池、这台柜子现在能不能收电池。缺不缺,看空格口数量;能不能收,应该看柜子自己的状态。
  2. 出错的一步在第二个判断。程序没有读柜子的服务状态,而是去工单表里查“这台柜子有没有电柜离线工单”,查到就跳过,查不到就认为可以收电池。
  3. 工单是处置过程留下的记录,柜子的在线状态来自设备自己的上报,两份数据各自维护,本来就可能对不上。记录没有说明这台柜子为什么没有离线工单,能确认的只是:它是离线待整改状态,而离线工单不存在。
  4. 这台柜子正好落在这个缺口里:查不到离线工单,被判定为可以收电池;又确实有空格口,两个条件同时满足,调入工单就生成了。
  5. 结果是一张不该存在的补货任务。一线看到的是正常的调入单,按单执行就是往一台正在整改的柜子搬电池,属于无效搬运,还可能和现场整改撞在一起。从记录看,生成之后没有环节会自动撤销它,最后是人工取消。

处置只取消了当前这张单,属于止血。修复方向是:把“能不能收电池”改回读柜子自身的服务状态,离线、待整改、停用一律不生成调入工单,工单是否存在只作为辅助提示;同时把这类被跳过的柜子记下来,便于核对是状态没同步,还是确实不需要补货。

用“有没有工单”代替“设备能不能用”,凡是状态不走工单这条路的柜子,过滤就整条失效。

下面的两段 Java 代码是脱敏教学示例,用于说明过滤条件取错对象与改法,不代表实际项目源码或已上线实现。

错误代码

// 给网点补电池:挑出需要生成电池调入工单的电柜(脱敏教学示例)
public List<InboundOrder> planInbound(String siteNo) {
    List<InboundOrder> orders = new ArrayList<>();
    for (Cabinet cabinet : cabinetRepo.listBySite(siteNo)) {
        // 为什么错:用“名下有没有电柜离线工单”代替“柜子当前能不能用”。
        // 这台柜子离线待整改但没有离线工单,在这里被当成可以收电池
        boolean hasOfflineOrder = workOrderRepo.exists(
                cabinet.getCabinetNo(), WorkOrderType.CABINET_OFFLINE);
        if (hasOfflineOrder) {
            continue;
        }
        int emptySlots = cabinet.getSlotCount()
                - batteryRepo.countInCabinet(cabinet.getCabinetNo());
        // 只判断了空格口,柜子的离线、待整改状态完全没有参与判断
        if (emptySlots > 0) {
            orders.add(new InboundOrder(cabinet.getCabinetNo(), emptySlots));
        }
    }
    return orders;
}

修复代码示例

// 同一段规则:把“能不能收电池”改成读柜子自己的状态(脱敏教学示例)
public List<InboundOrder> planInbound(String siteNo) {
    List<InboundOrder> orders = new ArrayList<>();
    for (Cabinet cabinet : cabinetRepo.listBySite(siteNo)) {
        // 改:能不能收电池只看柜子状态,离线、待整改、停用都不补
        if (!cabinet.canReceiveBattery()) {
            log.info("skip inbound, cabinet not serviceable, no={}, state={}",
                    cabinet.getCabinetNo(), cabinet.getState());
            continue;
        }
        int emptySlots = cabinet.getSlotCount()
                - batteryRepo.countInCabinet(cabinet.getCabinetNo());
        if (emptySlots > 0) {
            orders.add(new InboundOrder(cabinet.getCabinetNo(), emptySlots));
        }
    }
    return orders;
}

// 电柜状态:在线 / 离线 / 待整改 / 停用(示意)
public boolean canReceiveBattery() {
    return state == CabinetState.ONLINE;
}

下次遇到这些场景要警惕

  • 写“给设备补货、派单、调拨”这类规则时,把“设备还能不能用”单独拎成一个判断,确认读的是设备自己的状态字段,而不是订单、工单、任务的存在与否。
  • 构造一条“设备已停用、但名下没有对应工单”的数据跑一遍生成逻辑——例如状态先变、工单没有同日开出——观察是否仍会生成补货单,并确认工单表里没有新增记录。
  • 设备状态新增取值(比如待整改)时,回到所有按状态过滤的地方逐个核对:新值落在放行侧还是拦截侧,默认分支不能默认放行。
  • 看到“停用设备还在被派活”的单子,先查这张单由哪条规则、读了哪个字段生成,再核对生成时刻的设备状态,不要先怀疑是数据没同步。