发生了什么
换电柜按格口存放电池,每个格口是一个独立的电池位:格口可用时,才能放电池、参与换电。格口上有一个“是否禁用”的标志,被禁用的格口不会作为可用电池位开放。
电池在柜内报故障后,系统会把这块电池所在的格口置为禁用。之后故障电池被从格口取出、带走处理,这一步在系统里记为故障回收。正常应该到此收尾:故障电池已经离柜,格口里不再有它,禁用标志随之取消,格口重新可以放电池、继续使用。
这次不是。8 月初有反馈,故障电池已经离柜、回收也处理完了,格口的禁用标志却没有自动消失,格口一直保持禁用,不能继续使用。临时处置是运维手动启用这个格口;后续计划改成故障回收时自动取消格口禁用,原计划 8 月下旬完成。修复是否已经上线、上线后是否验证过,材料里没有结论。
本质
一句话:故障回收只把故障记录改成了已回收,没有去清故障时打在格口上的禁用标志;电池走了,禁用还留着。
拆开看:
- 电池报故障时,系统登记一条故障记录,并把电池所在格口置为禁用。禁用是格口自己的标志,不写在故障记录上。
- 故障电池被取出后,回收流程把故障记录改成已回收,回收这一步到此结束。
- 但回收流程没有对格口执行启用。禁用标志不在故障记录里,改记录不会顺带清掉它,于是回收显示已完成,格口却仍是禁用状态。
- 对使用者来说,这两个状态是矛盾的:回收侧认为这块故障已经处理完,柜子侧却还把这个格口锁着,不能放新电池、不能参与换电。反馈里说“禁用标志不会自动消除”,指的就是这个残留。
- 临时靠运维手动启用,能把单个格口恢复出来,但这是人工补动作,不是回收流程自己收尾;只要下一块故障电池再走一遍回收,同样会留下一个禁用的格口。
回收完成和格口可用是两件事:回收流程只结束了故障记录,没有清掉挂在格口上的禁用标志。
修复方向是:在故障回收的收尾步骤里,确认电池已经离柜后,取消这次故障产生的格口禁用,让格口回到可用状态;手动启用保留为异常兜底,不作为常规路径。修复是否实施、何时上线,材料里没有确认。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
public class FaultBatteryService {
/** 电池报故障:登记故障记录,并禁用电池所在格口 */
public void reportFault(String slotId, String batterySn) {
faultRecordRepository.save(new FaultRecord(slotId, batterySn, FaultStatus.WAIT_RECOVER));
slotRepository.disable(slotId);
}
/** 故障电池回收:电池离柜后结束回收 */
public void recover(String slotId, String batterySn) {
FaultRecord record = faultRecordRepository.findByBatterySn(batterySn);
record.setStatus(FaultStatus.RECOVERED);
record.setRecoveredAt(now());
faultRecordRepository.save(record);
// 为什么错:只把故障记录改成了已回收,
// 没有取消 reportFault 打在格口上的禁用标志,格口会一直不可用
}
}
修复代码示例
public class FaultBatteryService {
/** 电池报故障:登记故障记录,并禁用电池所在格口 */
public void reportFault(String slotId, String batterySn) {
faultRecordRepository.save(new FaultRecord(slotId, batterySn, FaultStatus.WAIT_RECOVER));
slotRepository.disable(slotId);
}
/** 故障电池回收:电池离柜后结束回收,并恢复格口可用 */
public void recover(String slotId, String batterySn) {
FaultRecord record = faultRecordRepository.findByBatterySn(batterySn);
record.setStatus(FaultStatus.RECOVERED);
record.setRecoveredAt(now());
faultRecordRepository.save(record);
// 故障电池已离柜,故障回收结束时取消格口禁用
slotRepository.enable(slotId);
}
}
修复版与错误版使用同一对象、同一入参,只多了回收末尾的一步:电池离柜后取消格口禁用。enable 为示意方法名,实际实现可以按禁用来源精确撤销;关键是回收完成时处理格口状态,而不是只改故障记录。
下次遇到这些场景要警惕
- 任何“异常时把资源置为不可用”的流程:先把这条流程改过的状态逐项列出来,再对照恢复路径逐项看有没有撤销;用一块故障电池完整走一遍上报、离柜、回收,最后回到柜前试换电,确认格口真的恢复可用,而不是只看回收记录显示已完成。
- 资源可用性和业务记录分开存储时:回收完成后做一次一致性核对,按已回收的故障记录反查对应格口,找出仍处于禁用状态的记录;残留可以先人工修正,但要把核对做成可重复执行的检查,避免每来一块故障电池都要人工再启用一次。
- 把“手动启用”作为临时处置时:确认手动操作有没有留痕、会不会被后续流程覆盖;临时方案只是把当前格口放出来,不能当成修复已验证,下一块故障电池仍会复现。
- 若格口还可能因其他原因被禁用(检修、人工停用):恢复流程只撤销本次故障对应的禁用,不能一律置为可用;这要求禁用时记录来源,恢复时按来源精确撤销。