发生了什么
换电电池是可以在柜子里循环的实物:用户把没电的电池放进换电柜、再取走一块满电的,柜子按电池编号识别每一块电池。每块电池有两个编号,一个是对外的电池编码,随电池流转被写入和读取;另一个是资产台账里的资产码,从投产到报废不变。
正常的流程是这样的:电池上报故障后,系统记下这块电池有故障,既写故障资产表,也在缓存里放一份故障标记;柜子读到这个标记,就把电池锁住、不让换出。电池返厂维修,修好后由城市侧在后台做「维保入库」签收,签收时会清掉这块电池的故障标记(下称消标),电池才算恢复可租、能重新进柜。
这次不同的是,工厂把维修好的电池换成了新的电池编码,旧编码不再使用。城市侧仍按正常流程做维保入库签收,消标也执行了,但只清掉了旧编码那一条缓存标记。签收完成后,后台按新编码查这块电池,结果仍然是有故障;电池放进柜子后也照样被判成故障电池锁住,用户换不到,维修等于白做。
一块电池换了编码,系统里就成了两个编号各带一份故障状态,而消标只认其中一个。
本质
故障状态本身是资产维度的:一块电池有没有故障,长期记在故障资产表里;电池当前使用的编码只是它对外的名字。为了少查库,查询故障时先按电池编码读缓存,没命中,就顺着这个编码找到资产码,去故障资产表查一次,查到有故障,再把「有故障」写进以电池编码为键的缓存。等于说,同一块资产的故障会被复制到它当前使用的每一个编码下面。
编号一变,这套读写就错位了:
- 故障上报时,缓存和故障资产表各记了一条,缓存这条的键是旧编码。
- 工厂换码,电池对外的编号换成新的,资产还是那一块,旧编码的缓存键没有人清。
- 业务按新编码查故障,缓存没命中,程序按编码找到资产码,发现这块资产有故障,于是又往缓存里写了一条以新编码为键的故障标记。此时一块电池对应两个缓存键,两个都写着有故障。
- 城市侧做维保入库签收,消标只清到旧编码那一条缓存标记,新编码这一条不在清理范围内。
- 之后按新编码做的查询都先命中缓存,直接返回有故障,不再回查资产表;柜子据此锁仓,电池用不了。
一句话:缓存键用了会变的电池编码,而故障状态是资产维度的;换码让一块资产分裂成两个键,消标只清掉一个,另一个键的旧值一直留着,读的人也不会再去核对源头。
目前系统并不支持故障维修后的换码,长期方案还要业务和产品评估。修复方向是:故障状态统一按资产码存、按资产码取;换码时把旧编码下的状态迁移或清掉;消标时按资产清掉该资产名下所有编码对应的键;已经产生的脏数据用批量消标处理。
错误代码
// 故障查询与维保入库后的消标(脱敏教学示例)
public boolean hasFault(String batteryCode) {
String key = "fault:battery:" + batteryCode; // 键是电池编码,换码就变
Boolean cached = cache.get(key);
if (cached != null) {
return cached; // 命中直接返回,不再核对资产
}
String assetCode = batteryMapper.selectAssetCode(batteryCode);
boolean fault = faultAssetMapper.existsFault(assetCode);
// 为什么错:资产上有故障时,把标记写进「当前编码」的键下。
// 换码后新编码也会被写一份,和旧编码各存一份,互不相干
cache.put(key, fault, FAULT_CACHE_TTL);
return fault;
}
public void clearFaultAfterInbound(String batteryCodeOnOrder) {
// 消标执行时用的还是换码前的旧编码
// 为什么错:清理范围只有旧编码这一个缓存键。换码后新编码的键
// 没有任何动作会清,而查询入口先读缓存,于是按新编码查依然有故障
cache.evict("fault:battery:" + batteryCodeOnOrder);
}
修复代码示例
// 修复方向:故障状态按资产存、按资产清(脱敏教学示例,未上线实现)
public boolean hasFault(String batteryCode) {
String assetCode = batteryMapper.selectAssetCode(batteryCode);
if (assetCode == null) {
return false;
}
String key = "fault:asset:" + assetCode; // 键换成不随换码变化的资产码
Boolean cached = cache.get(key);
if (cached != null) {
return cached;
}
boolean fault = faultAssetMapper.existsFault(assetCode);
cache.put(key, fault, FAULT_CACHE_TTL);
return fault;
}
public void clearFaultAfterInbound(String assetCode) {
// 消标按资产执行,不依赖单据上还记着哪个编码
faultAssetMapper.clearFaultByAsset(assetCode);
cache.evict("fault:asset:" + assetCode);
// 兼容历史上按编码写下的键:该资产名下所有编码的旧键一起清掉
for (String code : batteryMapper.selectCodesByAsset(assetCode)) {
cache.evict("fault:battery:" + code);
}
}
下次遇到这些场景要警惕
- 给一个按业务编号缓存状态的模块加「换编号」能力:先把该状态的读点和清点列全,确认换编号后旧键、新键分别由谁清;再用「旧编号有状态 → 换新编号 → 走一遍消标 → 按新编号查」完整跑一次,看是否仍读到旧状态。
- 维修、换件、过户这类会改对外编号的流程:检查以编号为键的缓存、索引、外部系统记录有没有跟着迁移,并验证一块资产在任一时刻只对应一个在用编号。
- 消标、解封、解冻这类「恢复可用」的动作:先确认清理范围是按单据上的编号还是按资产;构造换过编号的样本再执行一次,别只用没换过编号的电池验证。
- 缓存命中即返回的读路径:确认键里有没有会变的字段;只要键可能变,就要有旧键清理或版本迁移,否则旧值会一直留在缓存里,而读接口看起来一切正常。