发生了什么

换电业务里,电池要在网点之间调配:某个网点电池太少,就从别处运过来,这叫调入;电池有富余,就运去别处,这叫调出。每调一次,系统生成一张调拨工单,写明哪个网点、往哪个方向、哪种型号、调多少颗,由执行调运的人照单搬运,搬完把工单点完成。

工单有两种生成方式。一种是凌晨的批量算法:按前一天的数据算出各网点的缺口,一次性生成当天的调拨单,这类单优先级低。另一种是实时策略:运行过程中根据网点当前状态随时补单,优先级中。正常情况下一张单落到网点、执行完就结束;电池刚到站还没被用掉的时候,系统不该再给同一个网点派一张反方向的同型号工单,否则刚运进来的电池马上又让运走,这一趟搬运就白跑了。

这次一个网点在一天里拿到了两张方向相反的单。凌晨跑批在 04:50 生成了一张某型号电池的调入单,优先级低;15:29 这张单完成,一批该型号电池落到了这个网点。16:44,实时策略给同一个网点生成了同型号的调出单,优先级中;18:06 这张调出单也完成了。从调入完成到调出建单,中间只隔了 1 小时 15 分钟。

结果是同一网点同一天先收进一批同型号电池,又要往外调同型号电池,两张方向相反的工单留在系统里。反馈人当天 17:44 把问题报了上来。记录没有统计这类情况出现过多少次,也没写这两趟搬运多花了多少运力。

本质

一句话:判断“这个网点是不是已经有冲突的单”时,程序只查了还在进行中的工单,一小时前刚完成的那张调入单在它眼里等于不存在。

  1. 实时建单的流程分四步:准备参数、查该网点已有的系统工单、判断方向是否相同、决定建不建。第二步查工单时,状态条件只有一个值,就是进行中。16:44 建调出单时,04:50 那张调入单在 15:29 已经完成,状态是已完成,不在查询范围里,查询直接返回空。
  2. 查不到工单,程序判定“该网点不存在系统工单”,于是走到建新单的分支,把这张调出单建了出来。判断方向是否相同的逻辑排在第四步,只有查到了工单才会执行。也就是说,这段方向冲突检测天生只对进行中的工单生效,已完成的单没有机会参与比较。
  3. 回溯窗口本身不是瓶颈:查历史工单的时间窗口配置是 30 小时,04:50 的单完全落在窗口内。卡住的是状态范围,不是窗口长短。
  4. 系统里其实有一段专门为这个场景写的校验:建调出单之前,查这个网点在 2 小时内有没有已经完成的调入单。1 小时 15 分钟小于 2 小时,这单本该被它拦住。但这段校验只挂在人工建单和审批建单的入口上,系统自动建单走的是另一条创建路径,从头到尾没有调用它。而且这段校验里本地库查询的部分被整段注释掉了,只剩按 3 天窗口查外部数据源的那一半还在跑。
  5. 算法和实时策略之间的去重也是单向的。凌晨算法建单时会检查该网点有没有进行中的实时工单;反过来,实时策略建单时不会检查当天算法已经建过的单。本例的时序恰好是算法在前、实时在后,实时这一侧没有任何拦截。

三道检查各自都成立在自己的假设里:认为“已有工单”就是进行中的单,认为这套反向校验只服务人工建单,认为去重只需要管算法先建的情况。三个假设叠在一起,同一网点同型号电池在 1 小时 15 分钟内出现了一进一出。

记录里的处置只写了待产品优化,没有给出改动清单,也没有验证结果,修复上线状态待确认。修复方向是:把冲突查询的范围扩到回溯窗口内所有未取消的工单,方向比较对已完成的单也要生效;把反向冷却校验前移到系统建单的公共路径,人工入口和自动入口共用同一段判断;算法与实时的去重做成双向。改完还要注意,先查后建之间若有两次建单并发进来,仍可能都通过,需要唯一约束或锁兜底。

下面两段 Java 是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 实时调度建单:判断该网点是否已有冲突工单
public void handleDispatch(DispatchParam param) {
    // 第 2 步:查该网点已有的系统工单
    // 为什么错:状态只传了“进行中”,已完成的工单一条都查不回来
    List<DispatchTask> existing = dispatchTaskMapper.queryActiveTasks(
            param.getDealerId(),
            Collections.singletonList(TaskStatus.PROCESSING.getCode()));
    if (existing.isEmpty()) {
        // 为什么错:把“没有进行中的单”当成“没有任何单”,直接建了新单
        createNewTaskByParams(param);
        return;
    }
    // 第 4 步:方向判断只对着查回来的这几张进行中工单做
    if (isSameDirection(existing, param.getDirection())) {
        return;
    }
    createNewTaskByParams(param);
}

修复代码示例

// 人工入口与系统自动入口都调用这个方法,冲突判断只有一份
public void handleDispatch(DispatchParam param) {
    // 范围改成回溯窗口内所有未取消的工单,不再只看进行中
    List<DispatchTask> recent = dispatchTaskMapper.queryRecentTasks(
            param.getDealerId(), param.getBatteryModel(),
            param.getNow().minusHours(protectionHours));
    for (DispatchTask task : recent) {
        if (isSameDirection(task, param.getDirection())) {
            return;                              // 同方向已有单,不重复建
        }
        if (isReverse(task, param.getDirection())
                && task.getFinishTime() != null
                && task.getFinishTime().isAfter(
                        param.getNow().minusHours(finishCooldownHours))) {
            // 反向单刚完成,电池可能刚到站,不再派反方向调拨
            return;
        }
    }
    createNewTaskByParams(param);
}

下次遇到这些场景要警惕

  • 给“是否已存在”这类判断加状态过滤时:先列出这个对象的所有终态(完成、取消、关闭),再用一条“刚进入终态、仍在回溯窗口内”的数据跑一遍,看程序判成“不存在”还是判成“冲突”。
  • 校验只挂在一部分入口时:把建单入口列全——批量跑批、实时策略、人工建单、审批、补偿任务——逐个用“已存在反向工单”的输入走一遍,确认每个入口都调到同一段校验,而不是只看有人工入口的那条。
  • 两套任务源的时序:算法先建、实时后建,和实时先建、算法后建,是两条不同路径,两种顺序都要造数据跑;只测一种顺序等于只测了一半。
  • 改判断条件前核对配置:窗口类配置的命名单位和实际单位是否一致(名字里写 Days、实际按小时用),用 1 小时 15 分钟、2 小时、30 小时这几个边界值构造用例,确认拦截和放行的分界落在预期位置。