发生了什么

换电业务里,电池是平台自有资产,交给用户使用。每颗电池在物权表里有一条记录,写明它当前登记在谁名下,还有一个“最后活跃时间”——这颗电池最近一次在柜子里被识别、换入换出或上报状态的时间。用户的套餐到期后电池没有还回来,业务上叫“到期未归还”。

到期未归还的电池要安排人去找回。识别程序按到期未归还挑出电池,把物权表上的最后活跃时间当作“上报时间”(字段名 lastReportTime)传下去;策略侧先判断这颗电池要不要建单,放行后工单侧再校验一次,两边都通过才生成找回工单,派给一线。一线只在工单列表里看任务,列表里没有,就没有人知道要去哪找这颗电池。

正常结果有两种:该找回的电池生成工单;已经按赔付规则扣过款的电池(业务上叫“已发生资损”)不再找回,应当被明确拦下并留下原因。

这次不一样。产品比对两个数据源时发现,有一部分到期未归还的电池没有生成找回工单,工单列表里查不到它们。查这批电池的物权记录,最后活跃时间都是空的:它们长期没有流转,也就没有上报过活跃时间,识别程序把这个空值原样传给了下游。

本质

一句话:建单前用一个可能为空的活跃时间当放行条件,把“已扣款不用找”和“没有数据”两种不同情况压成了同一个“不建单”结论。

  1. 识别程序读过物权表,把最后活跃时间放进消息。长期未流转的电池,这个字段为空,消息里的上报时间也就是空。
  2. 策略侧收到消息,先做一次强校验:上报时间为空,就判定不需要建单,直接返回。
  3. 即使消息走到工单侧,工单侧对同一个字段还有一道同样的强校验,读到空值,同样不会生成工单。
  4. 两处跳过都不写原因、不计数、不告警。工单列表里只是少了一张单,从结果上看不出它曾经被判断过。

空值在业务上有两种可能:这颗电池早已按赔付扣款,确实不用再找;或者它只是长期停在某个地方没有上报,该找还得找。记录里也只说这批电池“可能”已经资损,没有逐颗核对。用一个空字段代替“是否已扣款”的判断,等于把“不用找”和“该找但没法建单”合并成一个分支,而“已发生资损才拦截”这条规则从头到尾没有被真正执行过,方案里也没有它。

再往前看,处置发起时也没有查这笔电池是否已经扣款。业务要的规则是:发起处置时先看资损状态,已扣款的不建单,其余照常建单;方案里没有这一条,拦截只能靠活跃时间恰好为空来“碰巧”实现,被漏掉的那部分没有任何提示。

修复方向是:在发起处置时增加资损校验,已扣款的电池明确拦截并记录原因;没有活跃时间但未扣款的电池不能因此不建单。具体是直接建单并在工单上标注数据缺失,还是先转人工核实,需要产品定规则。记录里这条仍停在“需要产品出需求”,修复上线状态待确认。

下面两段 Java 代码是按上述机制写的脱敏教学示例,只对比“用空时间当放行条件”和“先判资损状态再建单”两种写法,不代表实际项目源码或已上线实现;示例假设处置程序能读到这笔电池是否已发起扣款,修复方向取“建单并标注缺失”这一种。

错误代码

// 策略侧与工单侧共用的建单前校验(脱敏教学示例)
class RecoveryOrderGate {

    void onCandidate(RecoveryCandidate candidate) {
        if (!pass(candidate)) {
            // 为什么错:静默跳过,工单列表里看不出这颗电池来过,
            // 也没有任何记录说明它是已扣款还是缺数据
            return;
        }
        orderService.create(candidate);
    }

    private boolean pass(RecoveryCandidate candidate) {
        // 为什么错:把“没有活跃时间”当成“不需要找回”的唯一条件,
        // 而业务上真正该拦的是“已发起资损扣款”
        return candidate.getLastReportTime() != null;
    }
}

修复代码示例

// 同一处校验(脱敏教学示例):先判资损状态,缺时间不再等于不建单
class RecoveryOrderGate {

    private final WriteOffService writeOffService;   // 查是否已发起资损扣款
    private final SkipRecorder skipRecorder;         // 记录跳过原因,供对账排查

    void onCandidate(RecoveryCandidate candidate) {
        // 修复:按业务规则拦截,已扣款的电池不建单,但要留下原因
        if (writeOffService.hasDeducted(candidate.getBatteryNo())) {
            skipRecorder.record(candidate.getBatteryNo(), "WRITTEN_OFF");
            return;
        }
        // 修复:没有活跃时间只说明数据缺失,仍然建单并标注出来,
        // 具体标注后直接派单还是转人工,由产品规则决定
        boolean missingTime = candidate.getLastReportTime() == null;
        orderService.create(candidate, missingTime ? TimeFlag.MISSING : TimeFlag.NORMAL);
        if (missingTime) {
            log.warn("recovery order without report time, battery={}", candidate.getBatteryNo());
        }
    }
}

下次遇到这些场景要警惕

  • 给建单判断加字段校验时:把这个字段所有可能的取值列出来,特别是空值在业务上对应几种情况。如果空值既可能表示“业务上不需要处理”,也可能表示“数据缺失”,必须拆成两个分支,分别定义动作。
  • 处置流程依赖外部系统的状态时:不要用“另一个字段恰好为空”来间接实现拦截。把要用的业务状态(这里是是否已扣款)显式查出来,在发起处置的入口处校验,并把结果写进单据或记录。
  • 出现“应该建的单没建”时:先按业务主键在工单表里查一遍,再倒查消息里的关键字段有没有空值;重点看跳过分支有没有留痕——没有留痕的跳过,只能靠两边数据比对才能发现。
  • 策略侧和工单侧对同一字段各做一次校验时:把规则收敛成一份共用实现,改一处两边同时生效;否则修了策略侧,工单侧仍会按旧条件拦掉。