发生了什么

电池在使用过程中需要在网点之间调配。某个网点电池不够时,运维会开一张调度工单,把电池从别处调进来;每调进一块电池,就在这张工单上登记一条调度记录。工单上还保存一个调度数量,单位是块,表示这张工单累计调入了几块,页面直接读这个数字展示给运维看。正常情况下,实际调入几块,数量就应该是几,和工单下的调度记录条数对得上。

这次运维完成一张调度工单,实际调入了多块电池,提交之后系统显示只调度了 1 块。也就是说,页面上的数量和实际搬进网点的电池块数不一致,而且不止一张工单出现同样的结果,数量都被记成了 1。

本质

一句话:完成工单时程序要更新调度数量,它没有统计这张工单下全部调度记录,只取了分页查询的第一页,而这一页只有一条,于是把 1 当成了实际调入块数写回去。

  1. 运维在页面上提交完成操作,程序进入“更新调度数量”这一段处理。
  2. 这段处理要写的是调度数量,它先查这张工单已经登记的调度记录,再用查到的记录条数当作数量。
  3. 这次查询带了分页参数,每页只取一条。库里这张工单的调度记录明明有多条,程序却只拿到第一页的一条。
  4. 程序把这一页当成全部结果,按取到的这一条把调度数量更新为 1。
  5. 页面展示的是工单上保存的调度数量,所以运维看到的是 1 块,而工单下的调度记录其实是多条。

问题出在第 3 步和第 4 步之间:数量应该来自“这张工单一共有几条调度记录”,实际用的却是“这次查询返回了几条”。这两个数只在记录条数不超过一页时相等。分页参数越小,数量就越小;每页取一条时,结果恒为 1,所以不管实际调入几块,更新出来的数量都是 1。

拿一页的查询结果去推断总数,只要记录超过一页,数量就一定偏小,每页取一条时永远得到 1。

修复方式是改掉这段查询和计数逻辑,随代码发版;已有工单的数量是否需要重新核对,记录中没有说明。

错误代码

class DispatchService {
    void finishOrder(long orderId) {
        // 为什么错:每页只取一条,拿到的只是第一页
        Page<DispatchRecord> page = dispatchMapper.pageByOrderId(
                orderId, new PageRequest(1, 1));
        // 为什么错:用这一页的条数当作整张工单的调入块数
        int quantity = page.getList().size();
        // 结果:无论实际调入几块,数量都被写成 1
        dispatchMapper.updateQuantity(orderId, quantity);
        dispatchMapper.updateStatus(orderId, "FINISHED");
    }
}

修复代码示例

class DispatchService {
    void finishOrder(long orderId) {
        // 数量单独统计,不经过列表分页
        int quantity = dispatchMapper.countByOrderId(orderId);
        dispatchMapper.updateQuantity(orderId, quantity);
        dispatchMapper.updateStatus(orderId, "FINISHED");
    }

    // 确实需要遍历明细时:翻完所有页再累加
    int countByPages(long orderId) {
        int pageNo = 1;
        int total = 0;
        while (true) {
            Page<DispatchRecord> page = dispatchMapper.pageByOrderId(
                    orderId, new PageRequest(pageNo++, 200));
            total += page.getList().size();
            if (!page.hasNext()) {
                return total;
            }
        }
    }
}

上面的改法是从原因推导的方向,记录只写了“修改代码发版”,未说明具体改动与验证结果。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名与每页条数均为示意。

下次遇到这些场景要警惕

  • 完成、提交这类动作要写数量时:先看数量是从明细统计来的还是页面上传来的。如果是查明细算出来的,检查这次查询有没有分页、每页几条,再用两条以上的明细走一遍流程,核对数量是否等于明细条数。
  • 新增或修改分页查询时:把“只取第一页”和“要拿全部”分开。凡是需要总数、合计或条数的地方,改用统计查询,不要为了省事复用列表分页接口再取返回条数。
  • 页面上数量和明细同屏展示时:用多条数据构造场景。只有一条数据时,分页取一条和取全部的结果相同,这类缺陷测不出来。
  • 修完这段逻辑后:把已经完成、数量被写成 1 的工单单独核一遍,确认是否需要按实际调度记录重新计算,不要只改代码不处理历史数据。