发生了什么

换电柜给骑手换电池,柜内每个仓格放一颗电池。柜子收满了、再放不进电池的时候叫满仓,反馈里也有人把它叫爆仓。满仓意味着有人还电池还不了,系统这时会自动生成一张满仓工单,交给这台柜子所属网点的运维,把多余的电池调出去。

工单上有一个网点字段,决定这张单归谁处理、出现在哪个网点的工单列表里。电柜是可以在网点之间搬的:撤走一台电柜、调整点位时,运营在后台把它的绑定网点从原网点改成新网点,业务上叫换绑。换绑之后,这台柜子产生的单据都应该记在新网点名下。

建单程序并不每次都去读电柜主数据,它读一份缓存。缓存里存着“这台电柜当前属于哪个网点”,按电柜编号直接取,取不到才回数据库查一次,再把查到的结果写回缓存。这样建单时不用反复查库。

这次就出在这份缓存上。一台电柜已经换绑到新网点,换绑只改了主数据,缓存里那份旧网点没有被清掉。当天 17 点 19 分这台柜子满仓建单,程序从缓存里取网点,取到的还是换绑前的原网点,工单就记到了原网点上。反馈人在当天下午提出:柜子已经在新网点了,满仓却显示在原网点。

影响是这张满仓工单的归属网点错了。页面在原网点名下显示这次满仓,电柜实际所在的新网点没有这条单;只要缓存里还是旧网点,后续建单会继续按原网点落。

本质

不是建单时取错了字段,而是它读的那份副本没有人更新。

  1. 原流程里,换绑把电柜和新网点的关系写进主数据,这一步是对的。此后建单要查这台柜子属于哪个网点,应该得到新网点。
  2. 为了让建单快一些,程序把“电柜属于哪个网点”放进缓存,命中就直接用,不再查库。这份缓存是主数据的一份副本,只有被显式清掉或者重新写入时才会变。
  3. 换绑链路上没有任何一步去清这份缓存。换绑程序改完主数据就结束了,缓存继续返回换绑前的网点。
  4. 建单程序按电柜编号取缓存,拿到原网点,把它写进工单的网点字段,工单随后按这个字段归到原网点名下。
  5. 电柜物理上已经在新网点,系统里的满仓记录却在原网点,两边对不上。新网点看不到这台柜子的满仓,原网点收到一张自己已经不管的柜子的单。

主数据已经改了,缓存里那份副本没人清,建单程序读到的还是换绑前的网点。

修复方向是:换绑网点时,在同一个动作里清掉这台电柜的网点缓存,让下一次建单回源取到新网点;清理要放在主数据提交之后,否则并发的建单请求可能把旧值重新写回缓存。已经落错网点的满仓工单,需要按电柜当前绑定的网点改派或者重新建单。修复是否上线、错单是否已经处理,现有信息没有说明。

下面两段 Java 代码为脱敏教学示例,用于说明“换绑不清缓存、建单读旧网点”的机制与改法,不代表实际项目源码或已上线实现;类名、方法名与缓存键均为示意。

错误代码

// 换绑电柜所属网点:只更新主数据(脱敏教学示例)
@Transactional
public void bindSite(String cabinetNo, String newSiteId) {
    cabinetMapper.updateSite(cabinetNo, newSiteId);
    // 为什么错:换绑到这里就结束了,缓存里“电柜到网点”的旧值没有人清,
    // 之后建单读到的仍然是换绑前的原网点
}

// 满仓建单:网点优先从缓存取,未命中才回库(脱敏教学示例)
public void createFullOrder(String cabinetNo) {
    // 为什么错:建单直接信任缓存快照,不跟主数据做任何比对
    String siteId = siteCache.get("cabinet:site:" + cabinetNo);
    if (siteId == null) {
        siteId = siteCache.load(() -> cabinetMapper.selectSiteId(cabinetNo));
    }
    FullOrder order = new FullOrder();
    order.setCabinetNo(cabinetNo);
    order.setSiteId(siteId);          // 原网点被写进工单的网点字段
    orderMapper.insert(order);
}

修复代码示例

// 换绑:先落主数据,提交之后再清缓存(脱敏教学示例)
public void bindSite(String cabinetNo, String newSiteId) {
    cabinetMapper.updateSite(cabinetNo, newSiteId);
    // 改:主数据提交后清掉这台电柜的网点缓存,下一次建单必须回源
    // 放在 afterCommit 里,避免事务未提交时删掉、并发请求又把旧值写回
    afterCommit(() -> siteCache.evict("cabinet:site:" + cabinetNo));
}

// 满仓建单:缓存只做加速,取不到就回源(脱敏教学示例)
public void createFullOrder(String cabinetNo) {
    String siteId = siteCache.get("cabinet:site:" + cabinetNo);
    if (siteId == null) {
        // 改:回源读主数据,并把读到的值写回缓存,缓存从此与新网点一致
        siteId = cabinetMapper.selectSiteId(cabinetNo);
        siteCache.put("cabinet:site:" + cabinetNo, siteId);
    }
    FullOrder order = new FullOrder();
    order.setCabinetNo(cabinetNo);
    order.setSiteId(siteId);
    orderMapper.insert(order);
}

下次遇到这些场景要警惕

  • 给“对象属于哪个网点、哪个组织”这类关系加缓存时:先把所有会改这份关系的入口列出来,换绑、点位搬迁、网点撤销合并、后台批量改归属都算,逐个确认都在同一个动作里清了缓存,而不是只改主数据。
  • 改完绑定关系后马上验证:同一台电柜先换绑到新网点,操作完成后立刻触发一次建单(满仓、缺电都可以),看单据的网点字段是不是新网点,而不是等缓存自然过期。
  • 遇到“显示在原网点、原组织”的反馈:先直接取出缓存里这个对象的值和主数据比对,两者不一致就能确认是副本过期,不必从建单算法查起。
  • 清缓存的位置也要检查:放在主数据提交之后,不要在主数据还没提交时删,否则并发读可能把旧值写回缓存,看起来清了其实没清。