发生了什么

换电业务里,用户花钱买一份套餐,套餐有效期内可以到换电柜把没电的电池换成满电的电池,换下来的电池归平台所有,用户手上始终留着一颗。系统对每一颗电池都要知道两件事:它此刻在谁手里,是仍在用户租用中,还是已经还回柜子里;以及它有没有人在用。这两件事决定了系统接下来该对这颗电池做什么。

电池还回柜子后,如果一段时间没人取走,它占着柜里的仓位又一直没人用,系统会把它判成闲置,自动生成一张闲置工单,交给现场人员核实处理。判闲置的依据是电池状态数据:状态显示在站、也就是已经还回不在用户手上,这颗电池才会被圈进闲置工单。这类工单属于自定义工单,不是人工添加的,而是由配置好的规则自动产生——规则订阅一张业务表的变更消息,业务表每有一次变动就推一条消息出来,规则读到满足条件的记录就建单。闲置工单的圈选规则,读的正是这张表。

正常情形下,电池被用户租走,状态就不再是在站,规则自然不会命中;只有电池真的还回柜子、又长期无人使用,才应该出单。这次不一样:被建单的用户还在套餐有效期内,电池就在他手上正常使用,根本没有还回柜子;但自定义工单程序收到的那条消息里,这颗电池的状态写的是在站。程序按消息内容判断,认定它已经还回、处于闲置,于是生成了工单。问题出在数据本身对不上:业务方也确认这张表的数据不准确,电池明明在用户手上,推过来的消息却是在站。

结果是一张与事实相反的工单——用户套餐还在生效、电池还在用,工单却说这颗电池闲置在站。这类情况不是第一次出现,此前已反馈过,这次仍然复现。修复方向是产品侧梳理这套圈选逻辑,把它和这张离线表解开,不再拿这张表的数据直接判定电池是否闲置;截至记录时该方向尚未落地,上线与验证情况待确认。

本质

一句话:闲置工单的圈选把一张不准的业务表当成了事实来源,表里写“在站”就直接建单,建单前没有向实时归属核对,于是一颗在用户手上的电池被判成了闲置。

拆开看:

  1. 正常依赖是什么。电池是否闲置,取决于它此刻归谁、有没有人在用;权威数据在实时归属里,也就是电池当前绑在哪个用户名下、套餐是否生效。业务表只是这些数据的一份副本,被整理成便于按条件查询的形式。
  2. 实际执行的动作。自定义工单程序订阅这张表对应的变更消息,收到一条电池状态变化就取消息里的状态做判断,命中在站就按闲置建单。判断依据全部来自消息,程序没有别的输入。
  3. 副本为什么不能当事实。实物在用户手上,副本写的是在站;两张数据从这一刻起就是矛盾的,程序却只看到副本,于是算出来的结论与实物方向相反。
  4. 为什么没有兜住。建单前没有再问一次实时归属:这颗电池此刻是否还绑在用户、套餐是否还在生效。只要多核对这一次,就会发现它并没有闲置,工单不会生成。
  5. 为什么反复出现。判断长期挂在这张表上,只要表里这条数据不准,同样的工单就会再生成一次;清掉已生成的工单,改变不了下一次的结果。

修复方向是把圈选从这张离线表上解耦,以实时归属作为判定依据,离线数据最多只作为线索;在切换完成之前,建单动作可以先加一次实时核对作为兜底。

一张不准的副本表,会让规则把还在用户手上的电池判成闲置,而且只要数据不改,就会一直生成新的工单。

下面两段代码是按这条链路写的脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名与字段名均为示意。

错误代码

/** 自定义工单:消费业务表的变更消息,命中闲置条件就建单 */
public void onBatteryStatusChanged(BatteryStatusMessage msg) {
    // 为什么错:消息里的状态来自一张业务方已确认不准的表,
    // 电池实际在用户手上时,这里拿到的仍然可能是在站
    if (!"AT_STATION".equals(msg.getStatus())) {
        return;
    }
    // 为什么错:把消息直接当成事实,建单前没有向实时归属核对,
    // 这颗电池是否还绑在用户、套餐是否生效,一次都没有查
    WorkOrder order = new WorkOrder();
    order.setType("IDLE_BATTERY");
    order.setBatterySn(msg.getBatterySn());
    order.setStationId(msg.getStationId());
    workOrderMapper.insert(order);
}

修复代码示例

public void onBatteryStatusChanged(BatteryStatusMessage msg) {
    if (!"AT_STATION".equals(msg.getStatus())) {
        return;
    }
    String sn = msg.getBatterySn();
    // 改用实时归属作为判定依据:先看这颗电池此刻在谁手里
    Possession possession = possessionService.current(sn);
    if (possession.isRented()) {
        // 仍在用户租用中,说明消息是脏的:不建单,留痕供对账
        log.warn("状态消息与实时归属不一致,跳过建单, sn={}", sn);
        return;
    }
    WorkOrder order = new WorkOrder();
    order.setType("IDLE_BATTERY");
    order.setBatterySn(sn);
    // 站点也取实时归属的值,不用消息里的旧快照
    order.setStationId(possession.getStationId());
    workOrderMapper.insert(order);
}

下次遇到这些场景要警惕

  1. 让一张派生表或同步消息驱动业务动作前,先列出这张表由谁写入、已知有哪些不准的字段;对会建单、扣费、改状态的动作,确认它读的是权威源还是副本,读副本的就要配一次实时核对。
  2. 构造“实物与表里对不上”的数据:让一颗电池仍在用户租用中、套餐生效,同时把状态数据写成在站,跑一次圈选,断言不会建单,并检查程序是否留下了可用于对账的记录。
  3. 收到“同类工单反复出现”的反馈时,先查这几次工单的圈选是否都读同一张表、同一个字段,再决定是改规则还是换数据源;只清理已生成的工单,下一次数据不准还会再来一次。
  4. 给这类规则加一层拦截统计:观察每次建单前实时核对拦下的比例,比例持续偏高说明数据源已不可信,应该推动上游修正或切换来源,而不是继续在规则里加例外。