发生了什么

换电柜是给电动车用户换电池的设备:用户把没电的电池放进一个格口,再从另一个格口取走一块满电的电池。柜子由若干格口组成,格口分两种:换电格口参与取放电池;充电格口只给电池充电,不对外换出。柜里的换电格口都放了电池、再收不进电池时,系统判定为“满仓”,自动生成一张满仓工单,让运维把多余的电池调走。这个判断的前提是只数换电格口,充电格口里的电池不参与统计。

正常的判断是:先看这台柜子有哪些换电格口,再看这些格口是不是都被占着。都被占着才算满仓;只要还有一个换电空格,柜子就还能收电池,不该生成工单。

四月底,一次“可充可换”改造上线。这类柜子既能给电池充电,也能对外换电,满仓判断随之增加了一步:先把充电格口过滤掉,只拿剩下的换电格口判断满仓。具体过滤规则是否覆盖所有柜型,记录说还要和产品确认。

问题出在一台此前没有投入使用的纯充电柜上。它的格口全部是充电格口,柜里也没有电池。过滤之后,剩下的换电格口是零个,程序却把这台柜子判成了满仓,生成了一张满仓工单。已确认的结果是工单被生成,记录没有说明一共生成了多少张、持续了多久、是否有运维因此到场。

临时处置是把这次过滤的灰度关掉,让判断回到改造前的行为;正式怎么过滤,要等产品确认规则后再改造,修复是否上线记录没有说明。

本质

一句话:过滤掉充电格口后,一台纯充电柜剩下的换电格口是零个,程序把“一个都没有”当成了“全部都满”,于是生成了满仓工单。

  1. 改造前的判断只看换电格口。换电格口有空位,柜子还能收电池,不是满仓;换电格口全被占,才生成满仓工单。这个口径与“用户还能不能换出电池”一致。
  2. 可充可换改造上线时,满仓判断增加了一步:先把充电格口从统计里排除,只对剩下的换电格口做判断。这样充电格口里的电池不会被算进满仓的依据。
  3. 出错的一步在过滤之后。程序没有先问“还剩几个换电格口”,直接对剩下的列表做“是否全部占满”的判断。纯充电柜的格口全是充电格口,过滤后列表为空;而空列表在“全部满足”的判断下会返回真。这是很多语言里都存在的边界:对空集合判断“所有元素都满足某条件”,结果默认为真。
  4. 于是“零个可换格口”被读成了“所有可换格口都已占满”。两者在数据上都表现为没有可用的换电格口,业务含义却相反:前者是这台柜子根本不参与换电,后者是满到不能再满。程序按后者生成了满仓工单。
  5. 关闭灰度只是让这次过滤不再生效,判断回到改造前,纯充电柜暂时不会再被判满仓。正式修复需要把“没有换电格口”单独处理,不能和“换电格口全满”共用一个结果;具体规则和上线状态待产品确认。

过滤条件本身不是问题,错在过滤之后的空集合被当成了“全部占满”。

下面两段代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;格口类型、方法名与工单接口均为示意。

错误代码

// 满仓巡检:先过滤掉充电格口,再看剩下的换电格口是否全部占满
public void inspect(Cabinet cabinet) {
    List<Slot> swapSlots = cabinet.getSlots().stream()
            .filter(slot -> slot.getType() == SlotType.SWAP)
            .collect(Collectors.toList());
    // 为什么错:纯充电柜过滤后一个换电格口都不剩,
    // 空列表在“全部满足”的判断里返回 true,被当成了满仓
    boolean full = swapSlots.stream().allMatch(Slot::isOccupied);
    if (full) {
        // 为什么错:这里没有区分“没有换电格口”和“换电格口全满”,
        // 于是一台没有电池的柜子也生成了满仓工单
        workOrderService.createFullOrder(cabinet.getNo());
    }
}

修复代码示例

// 修复:先确认这台柜子有没有换电格口,再判断这些格口是否占满
public void inspect(Cabinet cabinet) {
    List<Slot> swapSlots = cabinet.getSlots().stream()
            .filter(slot -> slot.getType() == SlotType.SWAP)
            .collect(Collectors.toList());
    if (swapSlots.isEmpty()) {
        // 修复:没有换电格口就不属于换电满仓的场景,直接跳过
        return;
    }
    boolean full = swapSlots.stream().allMatch(Slot::isOccupied);
    if (full) {
        workOrderService.createFullOrder(cabinet.getNo());
    }
}

下次遇到这些场景要警惕

  • 给业务判断加过滤条件时:先列出过滤后可能为空的所有情况,比如全部格口都是充电格口、柜子还没配置格口;对每种情况明确“跳过、报错还是按不满仓处理”,再拿真实数据跑一遍。
  • 使用“全部满足/全部不满足”这类判断时:单独构造空集合测一次。空集合在多数实现里会让“全部满足”返回真,这类判断不能直接代表“满”,需要先判空再判断占用。
  • 按柜型区分的业务:纯充电柜、纯换电柜、充换一体柜各准备一台,用同一套满仓巡检跑一遍,确认只有后两类参与满仓判断,纯充电柜不生成工单。
  • 用灰度控制改动时:关闭灰度只是止血,要确认关闭后旧行为确实恢复,同时把“过滤后为空”的场景补进回归,避免下次重新打开时再出同样的工单。