发生了什么

换电业务里的电池是循环使用的资产,仓库收到一批电池后,操作员要在后台做入库:把这批电池逐颗登记为在库资产,之后才能投放到电柜。正常入库只做本地校验和写库存记录,一批几十颗到上百颗,接口在几秒内返回。

一次版本升级里,开发为入库流程增加了查询电池物模型的步骤。物模型是设备在物联网平台上的属性与能力定义,比如电量、温度这些字段的类型和取值范围。改造后,入库程序在循环里逐颗调用物模型查询接口,等上一颗返回后再处理下一颗。

上线后每次入库的电池都只有几十到上百颗,逐颗查询的耗时尚在接口允许的 5 秒以内。这次一次入库了 997 颗电池,程序仍然逐颗查询:近千次远程调用串行累加,整条业务链路耗时超过 5 秒;入库接口配置了 5 秒超时,链路上耗时被拉长到 5 秒以上的多个接口也陆续报超时。操作员看到报错后又连续点击了 3 次入库按钮,每次点击都重新跑一遍整批处理,远程调用和报错数量进一步增加。

结果是入库请求以超时结束,链路上多个接口集中报超时。记录没有说明这批电池最终是否入库成功、是否有补录,也没有给出报错接口的完整清单,本文不对此推断。开发在复盘里确认,改造时没有评估电池数量过多可能带来的性能问题。

本质

一句话:这次入库的耗时约等于电池颗数乘以单次远程查询耗时,而接口超时是固定的 5 秒;颗数从几十颗变成近千颗,逐颗串行调用就把耗时推过了超时线。

  1. 原流程。入库只做本地校验和写库,耗时基本固定;批量多出几十颗,只是多写几条库存记录。
  2. 新增步骤。改造在入库主流程里增加了逐颗查询物模型:每颗电池一次远程调用,循环里等结果返回后再处理下一颗。一次入库的远程调用次数等于电池颗数。
  3. 为什么之前没暴露。上线后每次只入几十到上百颗,调用次数少,总耗时仍在 5 秒内;改造时按这个日常量级评估,没有覆盖一次入库近千颗的批量。
  4. 这次怎么超的。997 颗电池产生近千次串行远程调用,单次耗时累加后整条链路超过 5 秒。入库接口等待超过 5 秒后超时;链路上其他耗时被拉长到 5 秒以上的接口,也相继报超时错误。
  5. 点击放大。操作员连点 3 次,每次点击都重新提交一遍整批入库,三个请求各自再跑一遍近千次循环。它不会让第一次请求变快,只会把远程调用量和报错量继续推高。
  6. 处置。记录给出的处理是把对物联网平台这个查询接口的依赖从入库流程中移除,入库不再逐颗查询;同时要求后续对可能出现大量电池的出入库场景先评估性能。记录状态为已完成,但没有给出改动上线后的验证数据与影响范围。

循环里逐颗调远程接口,耗时随电池颗数线性增长;接口超时却是固定值,批量一上来就必然越过。

错误代码

// 入库接口与逐颗查询(脱敏教学示例)
@PostMapping("/inbound/submit")
public Result submit(@RequestBody InboundOrder order) {
    // 接口超时配置为 5 秒(记录中的配置)
    return Result.ok(inboundService.inbound(order));
}

public void inbound(InboundOrder order) {
    List<InboundDetail> details = new ArrayList<>();
    for (String batteryNo : order.getBatteryNos()) {
        // 为什么错:每颗电池同步调一次物联网平台,循环里串行等待返回
        DeviceProfile profile = deviceClient.queryDeviceProfile(batteryNo);
        // 为什么错:调用次数等于电池颗数,批量越大总耗时越长
        details.add(buildDetail(batteryNo, profile));
    }
    // 为什么错:走到这里时链路可能已超过 5 秒的超时线
    inboundRepository.save(order, details);
}

修复代码示例

// 修复:入库主流程不再逐颗查物模型(脱敏教学示例)
public void inbound(InboundOrder order) {
    List<InboundDetail> details = new ArrayList<>();
    for (String batteryNo : order.getBatteryNos()) {
        // 修复:只用入库单和本地电池档案里已有的字段组装明细
        details.add(buildDetailFromLocal(batteryNo));
    }
    // 修复:入库请求内不再有远程查询,耗时不再随电池颗数线性增长
    inboundRepository.save(order, details);
}

两段代码改的是同一处:去掉入库循环里对物联网平台的逐颗查询,让入库耗时回到与电池颗数无关的量级。记录只确认了“移除依赖”这一项处理,批量查询或异步补齐只是可评估的替代方向,没有证据表明已经实施;改动后的验证结果和影响范围也没有更多信息。

下次遇到这些场景要警惕

  • 给同步接口新增“每条数据查一次远程服务”的逻辑时:先取业务历史上出现过的最大批量,按“条数 × 单次耗时”估算总耗时,和接口超时、上游超时逐层比对,看哪一层会先被击穿。
  • 日常批量只有几十上百条时:不要用平均值做容量评估;专门构造一次接近上限的批量,统计远程调用次数、总耗时和报错接口,确认结果仍能正常返回。
  • 入库、出库这类提交按钮没有防重时:在接口超时的场景下连续点击几次,观察每次点击是否各自执行整批处理、是否需要在提交期间禁用按钮或做幂等控制。
  • 同步主流程依赖外部平台查询时:先确认这个查询是否必须阻塞入库;如果必须保留,改成一次批量查询并设置调用上限,同时明确外部接口失败时是阻断还是降级。

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;接口名与方法名均为示意,5 秒超时来自记录中的配置。