发生了什么
换电业务里,用户骑车到网点,在电柜前扫码,把没电的电池放进柜子,再取走一颗满电的。一个网点的电池数量是有限的:用户多、换电频繁的网点很容易不够用,冷清的网点则会积压。系统因此在网点之间搬运电池,用的凭据是调度工单。工单分两种,写明某个网点要补进几颗电池的叫调入工单,写明要把几颗电池运走的叫调出工单。执行搬运的人按工单把电池送到网点、放进空仓,这张工单就算完成。已经派出、电池还在路上、工单还没完成的,叫在途工单。
算出“这个网点还差几颗”需要一个目标数,也就是库存到多少颗才算够。系统里有两套目标数并存:一套是城市策略给出的推荐电池数,按网点所在城市和它的换电情况算出来,示意为 5 颗,代表正常运营该达到的水平;另一套是紧急兜底的最小电池数,示意为 4 颗,低于它网点就有断供风险,属于保底。正常情况下一张工单应该一次把网点补到推荐数,完成后该网点不再出现在调入名单里,等库存真的被用户换走、掉到推荐数以下,才会生成下一张。
这次是反过来的。一个网点的一张调入工单在 19:13 完成,19:20 系统又给它生成了一张同型号的调入工单。这七分钟里没有骑手取走电池,网点库存没有被消耗,工单却认定它还差电池。反馈里确认的就是这一处矛盾:同一网点刚调入完没几分钟,又让再调入一次。
本质
问题在于同一件事被两套目标数分别算了一遍,两次用的目标数不一样。
- 网点当时的实时电池数低于推荐数,城市策略判定要调入,已经派出一张在途工单。此时调度程序要决定这张在途工单补到多少:它先看有没有在途工单,有的话改按紧急兜底的最小电池数取目标,示意补到 4 颗,对应工单数量就是 2 颗。
- 工单执行完成,网点实际库存变成 4 颗。搬运的量和工单的量对得上,这一步本身没有算错。
- 在途工单结束后,这个网点再被调度时走的是另一条分支,不再看紧急兜底,直接拿城市策略的推荐数 5 和实时库存 4 比较,差 1 颗,于是又生成一张调入 1 颗的工单。
两张工单单独看都说得通,合起来就是同一网点前一张刚完成、后一张紧跟着就来了,第二次补的正是第一次少补的那一颗。“有在途工单时用哪个目标数”这条优先级写反了:紧急兜底本应在库存已经跌破下限时出手保底,却在有在途工单时抢在正式策略前面,成了决定在途补多少颗的主口径。
同一个量被两套规则各算一遍,只要两次取的目标数不同,前一次的“完成”就会被后一次判成“还差”。
修复方向是调整存在在途工单时的目标数优先级,改为城市策略优先、紧急兜底其次:在途工单直接按推荐数补足,兜底只负责保证目标不低于最低库存,这样工单完成后不会再因为目标数不一致而立刻生成第二张。记录中这条问题的状态是已完成,但没有写明改动如何验证、也没有给出上线时间,修复是否已经生效无法从记录确认。
错误代码
private static final int MIN_BATTERY = 4; // 紧急兜底的最小电池数,示意 4
// 决定网点这一轮还差几颗:有在途工单时改用兜底的最低电池数当目标
public int needIn(Station station) {
int realtime = station.getRealtimeBattery(); // 实时电池数,示意 2
if (station.hasInTransitOrder()) {
// 为什么错:在途期间把最低库存当成目标数,只补到 4 颗,
// 城市策略的推荐数 5 被整段跳过
return Math.max(MIN_BATTERY - realtime, 0); // 算出 2 颗
}
// 在途工单完成后走到这里,改用推荐数,4 比 5 少 1,又要补一次
return Math.max(cityStrategy.recommend(station) - realtime, 0);
}
修复代码示例
private static final int MIN_BATTERY = 4; // 紧急兜底的最小电池数,示意 4
// 修复:目标数先取城市策略推荐值,兜底的数值只用来把目标抬到下限
public int needIn(Station station) {
int realtime = station.getRealtimeBattery(); // 实时电池数,示意 2
int recommend = cityStrategy.recommend(station); // 推荐数,示意 5
// 目标数与有没有在途工单无关,两种情况下算的是同一个口径
int target = Math.max(recommend, MIN_BATTERY); // 示意 5
// 在途工单同样按这个目标数算量,完成后不会再差出一颗
return Math.max(target - realtime, 0); // 3 颗,一次补足
}
下次遇到这些场景要警惕
- 给同一个量写第二套取值规则(保底值、推荐值、上限值)之前,先列出所有会用到这个量的分支,逐条写下各自的目标数,确认同一张工单从生成到完成的全程只用一个目标数。
- 构造“在途工单前后”的对照:让网点实时数低于推荐数、高于最低库存,先生成在途工单并执行完成,立刻再跑一次调度,看会不会多出第二张工单。
- 检查兜底规则的出手条件,确认它只在库存跌破下限时生效;如果兜底值会被用来决定在途工单的数量,就等于让保底值替换了正式策略。
- 排查“刚完成又生成”类问题时,不要只看新工单自己的计算是否合理,把前后两张工单的目标数、在途量、完成时的库存列在同一张表里,差额往往就是两次口径之差。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。