发生了什么

换电业务里,电池是平台持有、交给用户使用的资产。每颗电池在系统里有一份电池档案,记着这颗电池当前由谁在用、这次使用到什么时候结束。用户要能持续把电池留在手上,需要买套餐——一份套餐写明一段可以使用电池的期限,有开始生效的时间和结束的时间。电池档案到了结束时间、电池还没有还回来,就叫到期未归还;这时运营要安排人把电池找回来,找回这件事在系统里落成一张找回工单,派给一线去现场处理。

正常流程是:系统按电池档案的结束时间筛出到期未归还的电池,再看使用人此刻还有没有可用的套餐。用户确实还在套餐期限内,说明电池由他继续使用是正常的,不派单;用户已经没有可用套餐,才生成找回工单、派给一线。

这次不一样。一颗电池到期未归还已经二十天,档案一直停在到期未归还的状态,但找回工单始终没有生成,一线在工单列表里看不到这颗电池。原因是该用户刚续费了一份新套餐,处于待生效状态,旧套餐已经结束。系统查询套餐时只看用户名下有没有套餐记录,待生效的新套餐也被算作“有套餐”,于是每天都走“用户还有套餐、不需要找回”的分支。记录只写了这一条反馈,同期还有多少同类电池被这样漏掉,没有统计。

本质

问题出在判断“用户还有没有使用资格”这一步:程序把套餐记录的存在当成了资格的有效。

  1. 选到期电池:程序按电池档案的结束时间,把到期未归还的电池挑出来,这是生成找回工单的入口。
  2. 判断要不要找回:对每颗电池,程序去查使用人名下有没有套餐。查询只按用户维度取记录,不带生效时间和状态条件,只要查到至少一条就返回“有套餐”。
  3. 待生效套餐混进来:用户新续费的套餐还没到生效时间,旧套餐已经结束。它同样是一条挂在用户名下的记录,所以第 2 步照样返回“有套餐”。
  4. 分支走错且不留痕:既然判定用户还有套餐,程序就认为电池由用户继续使用是正常的,直接跳过建单。这个分支被当作正常情况,不抛异常、不告警,也没有把“因有套餐而未生成”写进可查的记录,所以工单列表里只是少了一张单,从结果上看不出它是被判断掉的。
  5. 结果:电池档案停在到期未归还,一天天累加,二十天里每天的判断都落到同一分支,没有一张找回工单生成,一线也就没有可执行的任务。

把“存在一条套餐记录”当作“此刻仍在套餐有效期内”,是这颗电池一直等不到找回工单的原因。记录同时说明,这套判断是早先留下的逻辑,一直没有校验套餐的生效状态;是否应该为待生效套餐覆盖的逾期电池建单,需要产品给出新规则,记录里还没有。修复方向是:把判断改成“当前时刻是否落在某条套餐的生效区间内、且该套餐状态为生效”,待生效的套餐不再计入有效;待生效期间是否建单、生效后是否补建,由产品单独定义。改完之后,之前被抑制的档案能否按新规则补出工单,也要一并回溯确认。

下面的 Java 代码是按上述机制写的教学示例,用于对比“只看有没有记录”和“看此刻是否生效”两种判断,不代表实际项目源码或已上线实现。

错误代码

// 判断到期未归还的电池是否需要生成找回工单(教学示意)
public class RecoveryOrderService {

    private final PackageRepository packageRepository;

    public void checkOverdueBattery(BatteryArchive archive, LocalDateTime now) {
        // 为什么错:只按用户查“有没有套餐记录”,查询不带生效时间和状态
        boolean hasPackage = packageRepository.existsByUserId(archive.getUserId());
        if (hasPackage) {
            // 为什么错:待生效的新套餐也会让这里为 true,程序直接跳过建单
            // 这条分支被当成正常情况,既不告警,也没记录跳过的原因
            return;
        }
        createRecoveryOrder(archive, now);
    }

    private void createRecoveryOrder(BatteryArchive archive, LocalDateTime now) {
        // 建单细节省略,只保留与判断有关的入口
    }
}

修复代码示例

// 同一处判断:只认此刻生效的套餐,待生效的单独标记
public class RecoveryOrderService {

    private final PackageRepository packageRepository;
    private final RecoveryOrderRepository orderRepository;

    public void checkOverdueBattery(BatteryArchive archive, LocalDateTime now) {
        // 生效中:状态为生效,且 now 落在生效区间内
        if (packageRepository.existsActive(archive.getUserId(), now)) {
            orderRepository.recordSkip(archive.getId(), "active_package", now);
            return;
        }
        // 待生效:用户已续费但资格尚未开始,不能当成“还有套餐”而抑制建单
        packageRepository.findPending(archive.getUserId(), now)
                .ifPresent(p -> orderRepository.markPendingCoverage(archive.getId(), p.getId()));
        // 没有生效套餐就建单;待生效期间是否派单、是否等生效后再处置,由产品规则决定
        createRecoveryOrder(archive, now);
    }

    private void createRecoveryOrder(BatteryArchive archive, LocalDateTime now) {
        // 建单细节省略,只保留与判断有关的入口
    }
}

下次遇到这些场景要警惕

  • 给到期、超期类任务加建单条件时:把条件拆成“对象是否存在”和“对象此刻是否有效”两层,分别构造记录不存在、待生效、已过期、生效中四种数据,逐个跑一遍,确认每种情况下建单结果都符合预期。
  • 判断用户还有没有资格时:不要用 count 大于零或 exists 直接当结论,把时间区间和状态写进查询条件;重点检查新购、续费后立刻触发的场景,这时新记录通常还是待生效。
  • 排查“工单或任务没生成”时:先确认触发入口有没有筛到这条数据,再逐个检查跳过分支有没有留下原因记录;没有留痕的跳过分支,出问题时只能从结果反推,二十天都没人发现。
  • 修改这类历史判断逻辑前:先问清业务上待生效、已失效、跨生效边界分别怎么处理,让产品给出规则再改;只动一处判断,可能同时改变建单、派单和统计口径。