发生了什么

调度工单是安排电池调入的任务单。一张工单下面有一个明细列表,每调入一颗电池,就新增一条明细;工单左上角另有一个汇总数量,单位也是颗,表示这张工单累计调入了几颗。正常时两者应该一致:明细有几条,汇总就是几。

电池调入和工单完成是两个入口。调入入口负责写明细、加汇总;完成入口负责把工单状态改成已完成。按设计,完成只改状态,数量应该由调入那边维护。

这次,一张工单在完成的同时,另一颗电池的调入也在处理。完成后页面显示:明细列表有 3 条调入记录,左上角汇总只有 2 颗。同一张工单、同一个页面,两个数字对不上。目前只确认了这一张工单,是否还有同类工单待核实。

本质

一句话:完成工单时,程序拿一份只有 2 条的明细快照重算汇总并整值写回;与此同时,调入入口已经写进第 3 条、把汇总加到 3,完成时的写回又把 3 覆盖成 2。

  1. 完成入口拿到了明细快照。完成处理用它重算这张工单的汇总数量。这一步读到的还是 2 条。
  2. 调入入口写第 3 条。每调入一颗电池,程序新增一条明细记录,再把工单上的汇总数量加一。就在完成处理读完快照、还没写回的时候,另一颗电池的调入落库:明细变成 3 条,汇总从 2 加到 3。
  3. 完成入口整值覆盖。完成处理把工单状态改成已完成,同时把按旧快照算出的 2 写回汇总数量。它写的是整值,不是增量,刚加上去的 3 被改回 2。
  4. 页面从两个来源读同一张工单。明细列表读明细记录,看到 3 条;左上角读工单上保存的汇总数量,看到 2。两个数字从此不一致。

问题不在“2 加 1 算错”,而在完成动作拿了过期的明细快照,去覆盖一个由调入入口维护的汇总数量;两个入口都写同一个汇总数量,后写的整值盖掉了先写的增量。

修复方向是:完成动作只写状态,不再用明细快照重算或覆盖汇总;汇总数量继续由调入入口按增量维护。修复上线状态待确认,存量数据是否订正也待确认。

错误代码

class DispatchTaskService {
    void finishTask(long taskId) {
        // 为什么错:完成时按工单读明细,这份快照里只有 2 条
        List<InboundDetail> snapshot = detailMapper.selectByTaskId(taskId);
        // 并行时调入可能已插入第 3 条,并把汇总加到 3
        // 为什么错:状态和计数一起写,计数用旧快照的 2 整值覆盖
        taskMapper.updateStatusAndCount(taskId, "DONE", snapshot.size());
    }

    void addInbound(long taskId, String batteryNo) {
        detailMapper.insert(new InboundDetail(taskId, batteryNo));
        // 调入按增量维护汇总,这一步本身没错
        taskMapper.increaseInboundCount(taskId);
    }
}

修复代码示例

class DispatchTaskService {
    void finishTask(long taskId) {
        // 只推进状态:不再用明细快照重算或覆盖汇总
        taskMapper.updateStatus(taskId, "DONE");
    }

    void addInbound(long taskId, String batteryNo) {
        detailMapper.insert(new InboundDetail(taskId, batteryNo));
        // 汇总只由调入入口按增量维护
        taskMapper.increaseInboundCount(taskId);
    }
}

上面的改法是从原因推导的方向,未实施也未验证。代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名与状态常量均为示意。

下次遇到这些场景要警惕

  • 给工单增加“完成、关闭”这类状态动作时:先列出这个动作会写哪些字段;如果它还会重算明细汇总,构造“完成与新增明细同时进行”的并发场景,完成后再核对明细条数与汇总数。
  • 汇总数由明细维护时:不要在两个入口各自读明细再写总数;把计数收敛到明细新增、删除的同一条语句或同一事务里,用增量而不是整值覆盖。
  • 页面同时展示汇总数和明细列表时:确认两个数字分别从哪里读;出现不一致时先以明细为准核对落库数据,不要只改页面显示掩盖差异。
  • 验证并发修复时:用两个线程或两次请求控制“完成先读、调入后写、完成再写回”的时序,重复多轮,断言最终汇总始终等于明细条数。