发生了什么

套餐是用户按租期使用一块电池的服务,到期前把电池还回电柜,这一期就正常结束。系统里另有一条“电池绑定关系”,记录哪块电池现在在谁手上:用户取走电池时写一条绑定,电池归还后这条记录改成已解绑。到期时系统按用户查一遍名下还有没有绑定中的电池:没有,算已归还;还有,就按未归还处理并加收滞纳金。滞纳金是到期后电池仍被认为没还而产生的费用;平台同时给了用户有限的豁免机会,用一次少一次。

正常流程是这样的:用户把电池还到电柜,运维把电池放进柜子并在系统里做入柜操作,系统发现这块电池还挂在某个用户名下,就同步解绑这条绑定关系,把记录改成已解绑。此后到期检查按用户查不到这块电池,也就不该再产生任何费用。

这次不一样的地方在于,解绑确实执行了,绑定表里的记录也已经改成已解绑,而且解绑就发生在这期到期检查之前的二十多分钟。但到期检查按用户去查名下电池时,仍然查到了这块电池,系统于是按“电池还没还”算出一笔滞纳金。用户不认可这笔钱,为了尽快把账处理掉先用掉了一次豁免机会,随后进线要求说明:明明在到期前就归还并解绑了,为什么还会算出滞纳金。这笔滞纳金具体是多少、还有多少用户遇到同样情况、问题持续了多久,记录里都没有写。

本质

解绑这个动作本身做对了,错在解绑之后没有把“用户名下有哪些电池”这份缓存一起清掉,而到期检查恰好先读这份缓存。

  1. 系统把“用户名下有哪些电池”按用户分别缓存成一份列表,键里带用户标识,示意为 user:boundBatteries:{userId}。到期检查按用户查名下电池时优先读这份缓存,命中就直接返回,不再回库查最新绑定。
  2. 运维入柜触发的联动解绑,按电池号找到这条绑定记录,把状态改成已解绑。这一步落库是正确的,库里已经查不到这条绑定。
  3. 但这段代码只改了表,没有删除第 1 步那份按用户区分的缓存,也没有等它自然过期。对同一个用户,缓存里仍是解绑前的那块电池号。
  4. 套餐到期时,检查程序读缓存,拿到“用户名下还有这块电池”,据此判定电池未归还,于是算出一笔滞纳金;用户看到这笔费用,自然认为系统没有执行解绑。

解绑只改了绑定表,按用户缓存的电池号没有清,到期检查读到旧值,就把已经还回来的电池当成还在用户手上。

记录给出的原因是“表记录更新正确,用户与绑定电池的缓存未正确清除”,处置结果只写了已完成,没有写具体改动了哪段代码、是否已验证。修复方向是:在解绑成功的同一处清掉该用户维度的绑定缓存,按电池反查的键也一并清;在判定逾期、开始计费之前,对缓存结果和库里最新绑定记录做一次核对。记录没有说明是否另外给这份缓存加了过期时间兜底,也没有说明存量被误算的账单如何处理。

下面的代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 运维把电池还入电柜时的联动解绑(脱敏教学示例)
public void unbindOnPutInto(String batteryNo) {
    BatteryBinding binding = bindingMapper.findActiveByBatteryNo(batteryNo);
    if (binding == null) {
        return;                                  // 本来没有绑定,不用处理
    }
    bindingMapper.close(binding.getId(), UnbindReason.PUT_INTO_CABINET);
    // 为什么错:只改了绑定表,没有删除“用户名下电池号”的缓存;
    // 到期检查读的是这份缓存,读到的仍是解绑前的电池号
    log.info("battery {} unbound from user {}", batteryNo, binding.getUserId());
}

// 到期检查:按用户取当前绑定中的电池号
public List<String> boundBatteryNos(Long userId) {
    String key = USER_BOUND_KEY_PREFIX + userId;  // 键按用户区分(示意)
    List<String> cached = cache.get(key);
    if (cached != null) {
        return cached;                            // 命中缓存直接返回旧列表
    }
    List<String> fromDb = bindingMapper.findBoundBatteryNos(userId);
    cache.set(key, fromDb, ONE_HOUR);
    return fromDb;
}

修复代码示例

// 运维把电池还入电柜时的联动解绑(脱敏教学示例)
public void unbindOnPutInto(String batteryNo) {
    BatteryBinding binding = bindingMapper.findActiveByBatteryNo(batteryNo);
    if (binding == null) {
        return;
    }
    bindingMapper.close(binding.getId(), UnbindReason.PUT_INTO_CABINET);
    // 修复:解绑后立即删除该用户维度的绑定缓存,让下一次读回源到库;
    // 先更新库再删缓存,删除之后的下一次读会回源到库,读到已解绑状态
    cache.delete(USER_BOUND_KEY_PREFIX + binding.getUserId());
    // 反查方向的键一起清,避免另一条读路径继续命中旧值
    cache.delete(BATTERY_BOUND_USER_KEY_PREFIX + batteryNo);
    // 若解绑包在事务里,删除要放到事务提交之后,
    // 否则提交前插入的并发读可能把旧值重新写回缓存
}

下次遇到这些场景要警惕

  • 给已有对象新增“顺带解绑、顺带修改”的写路径时,先把所有读这份数据的入口列出来:页面查询、到期检查、计费任务各读库还是读缓存。构造“还入电池后立刻触发一次到期检查”,观察系统是否还判未归还。
  • 缓存里放的是集合(用户名下多个电池号)时,增删其中一个元素也要让整个键失效,只清单块电池的键不够。用一个名下有两块电池、只归还其中一块的用户验证。
  • 在让“是否归还、是否绑定”这类直接决定收费的判断依赖缓存之前,加一次按业务主键回库的核对,或给判定结果留人工复核入口;本例里表记录是对的,只有缓存是旧的。
  • 处理“明明还了还被收费”的客诉时,先按电池号和用户分别核对绑定表与缓存两侧的值,再决定是改数据还是清缓存;只改表不会让已经算出来的费用消失,还需要一并确认豁免机会是否被误扣、能否补回。