发生了什么

换电业务里的电池是平台的一项重要资产。用户租的不是电池本身,而是一段期限内使用电池的资格,业务上叫电池套餐。套餐到期后,用户如果把电池还回柜子,这次租用就结束了;如果没还,电池还留在用户手里,运营就要安排人把它找回来。这个动作在系统里落成一张找回工单,交给一线按电池定位去现场处理。

工单上有一个到期时长标签,按这颗电池的套餐过期了多久来分档,比如到期1至3天。标签直接告诉一线这颗电池已经过期多久,用来判断这单有多急、先处理哪一批。正常流程是:套餐到期且电池未归还,风险识别规则扫到这颗电池,生成一张找回工单,标签按当时的到期天数算好;一线到现场,如果确实找不回来,就在工单上登记未找回原因,比如联系不上用户、电池已经被带走。登记之后,规则不会立刻再生成工单,而是按未找回原因隔7天或14天再生成一次,继续催办,如此循环,直到电池找回或者规则判定不必再催。

这次的问题就出在第二轮、第三轮的工单上。一颗电池的套餐实际已经到期11天,工单标签还显示到期1至3天。标签不是写错了字,工单上挂的仍然是它第一次创建时算出来的那一档,页面把它原样展示出来。影响多少颗电池、持续多久没有统计,能看到的是这条反馈里标签与实际到期时长已经差了一个档位以上。

本质

问题不在标签的算法,而在重新生成工单时复用了缓存里的旧工单,旧标签跟着一起回来了。

  1. 工单创建时,标签按当时的到期天数算一次就写进工单。时间再往后走,工单里的这个值不会自己变化,过后多久都还是建单那天的档位。
  2. 一线登记未找回原因后,规则按这个原因把那张工单缓存下来,等到7天或14天后再用一次。
  3. 窗口到期时,程序没有按新规则建一张新工单,而是把缓存里那张旧工单重新启用:状态改回待处理,标签沿用当初那一档。
  4. 于是电池已经到期11天,页面显示的还是到期1至3天。再往后每催一轮,实际到期天数继续增长,标签却始终停在最初那一档,偏差越拉越大。
  5. 一线看到的紧急程度低于实际,按标签判断优先级时容易被误导;同一颗电池的工单记录也不再反映它当前到底到期多久。

缓存里存的是业务结果,重新启用时就把很久以前的旧结果当成了当前状态。

修复方向是:缓存只按未找回原因记录“什么时候可以再次生成”,窗口到期后这条缓存逻辑直接结束,不再重启旧工单;需要继续催办时新建工单,标签按当前到期天数重新计算。修复的上线与验证状态,记录没有说明。

下面的 Java 代码为脱敏教学示例,用于说明“缓存并重启旧工单导致标签不更新”的机制与改法,不代表实际项目源码或已上线实现。

错误代码

// 风险识别规则周期扫描:套餐到期且电池未归还时生成找回工单(示意)
public void generateRecoveryOrder(Battery battery) {
    String reason = battery.getUnfoundReason();
    CachedOrder cached = ruleCache.get(battery.getNo(), reason);
    if (cached != null && cached.getEndTime().isAfter(now())) {
        return;                              // 观察窗口内不重复建单
    }
    if (cached != null) {
        // 为什么错:窗口到期后重启缓存里的那张旧工单,
        // 标签仍是初次创建时算出的“到期1至3天”,没有按当前时间重算
        cached.getOrder().setStatus(WAIT_HANDLE);
        orderMapper.update(cached.getOrder());
        ruleCache.put(battery.getNo(), reason, cached.getOrder(), now().plusDays(nextIntervalDays(reason)));
        return;
    }
    RecoveryOrder order = new RecoveryOrder();
    order.setBatteryNo(battery.getNo());
    order.setExpireLabel(expireLabel(daysBetween(battery.getExpireTime(), now())));
    order.setStatus(WAIT_HANDLE);
    orderMapper.insert(order);               // 标签只在建单这一刻计算
    ruleCache.put(battery.getNo(), reason, order, now().plusDays(nextIntervalDays(reason)));
}

修复代码示例

public void generateRecoveryOrder(Battery battery) {
    String reason = battery.getUnfoundReason();
    // 改:缓存只存“下次可生成时间”,不存工单对象,也不存标签
    LocalDateTime nextTime = ruleCache.getNextGenerateTime(battery.getNo(), reason);
    if (nextTime != null && nextTime.isAfter(now())) {
        return;                              // 观察窗口内不重复建单
    }
    // 改:窗口到期后直接结束这条缓存规则,不复用旧工单
    ruleCache.clear(battery.getNo(), reason);

    // 改:按当前到期天数重新计算标签,新建工单
    RecoveryOrder order = new RecoveryOrder();
    order.setBatteryNo(battery.getNo());
    order.setExpireLabel(expireLabel(daysBetween(battery.getExpireTime(), now())));
    order.setStatus(WAIT_HANDLE);
    orderMapper.insert(order);
    ruleCache.putNextGenerateTime(battery.getNo(), reason, now().plusDays(nextIntervalDays(reason)));
}

下次遇到这些场景要警惕

  • 给“过期后按天数分档”的标签加缓存或复用:构造一颗已过期很久的电池,把初次生成、窗口内跳过、窗口到期后再次生成三步各跑一次,检查每次工单上的标签是否与当时的到期天数一致,而不是停在第一次的值。
  • 为了“避免重复建单”引入观察窗口时:先写清缓存里存的是什么。只存下次可生成时间这类控制信息;工单、金额、档位这类业务结果不要放进复用路径,重新生成时必须重新计算。
  • 排查“标签、档位、天数不刷新”的反馈:先看这条记录是不是被重启过——状态被改回待处理、创建时间明显早于当前时间;确认是复用问题后再看计算函数,不要一上来就怀疑算法或数据源。
  • 调整未找回原因的续催周期时:用同一种原因连续催两轮,比对两轮工单的创建时间和标签,确认每轮都是新记录,而不是同一条记录被反复启用。