发生了什么

工作人员一次核对多条账单记录,系统要逐条把结果推送给另一个账务系统,并更新自己这边的处理状态。

小批量可以完成,数量增加后却超时。有的记录已经推送,有的还没推送;本地状态也只改了一部分。

本质

系统每处理一条,都要等远端返回,再处理下一条:

  1. 单条处理虽然不算慢,但一条条等待,总时间会不断累加。
  2. 批量增大后,总时间超过了这次请求允许等待的时间。
  3. 请求被中断,之前已经推送的数据却不会自动撤销。
  4. 两边的数据停在不同阶段,部分操作锁也没有释放。

一批操作提示失败,不代表里面每一条都没做过。

短期通过限制单批数量降低失败风险。长期需要改为后台任务,支持查询进度和处理失败记录,改造完成情况待确认。

错误代码

// 后端在一次 HTTP 请求里,逐条等待远端服务。
for (BillItem item : items) {
    billingClient.push(item);
    localRepository.markDone(item.getId());
} // 中途超时后,前面已推送的数据并不会自动撤回

修复代码示例

// 提交接口:先保存任务及明细,再返回可查询的任务编号。
String submitBatch(List<BillItem> items) {
    return jobService.savePendingJob(items);
}
// 后台处理方法:逐条执行并保存结果。
void processItem(String jobId, BillItem item) {
    billingClient.pushOnce(item.getId(), item);
    jobRepository.markItemDone(jobId, item.getId());
}

提交接口和后台方法是两段独立的 Java 代码。任务系统还需要调度、恢复执行、速率限制及逐条结果查询;超时结果先查单,远端按稳定业务编号防止重复处理,不能仅把循环搬到另一个线程。

下次遇到这些场景要警惕

  • 批量操作里逐条调用别的系统:用最大允许数量测试,并让对方响应变慢,检查整批仍能按预期完成或明确结束。
  • 处理到一半失败:逐条核对哪些已成功、哪些没执行、哪些结果不确定,同时检查操作锁是否正确释放。
  • 用户准备再次提交整批数据:确认已成功的记录不会重复推送,失败记录能单独继续处理,用户能查到实际进度。