发生了什么

换电业务里,骑手不用在原地等电池充满,而是到换电柜前把没电的电池放回柜子,再取走一颗满电电池。系统要维持一条归属关系:骑手的电池挂在他名下,归还时解掉。名下还有电池挂着,换电流程就无法继续。柜子每开一次门让人取放电池,后台都会落一条开仓台账记录,记录里的 orderStatus 表示这次开仓的结果,0 是成功,1 是失败。另有一份流转记录,用来记录电池的流转过程。

正常一次归还加换电是这样的:骑手把电池放进柜子,柜门打开、电池被收进柜子,系统解绑这颗电池;接着换电开仓成功,骑手取走满电电池,名下换成新的那颗。前端按返回结果决定继续还是提示重试,不会带着一次没完成的开仓往下走。

这次不一样:骑手归还的不是自己名下挂着的那颗电池,而是另一颗,归还这一步系统判定为成功。随后换电时,系统又发起了一次开仓,柜子这次并没有真的打开,台账里 orderStatus 写的是 1,也就是失败。但接口给到前端的却是成功。前端按成功继续,失败分支没有执行,这次交接也没有被纠正,那颗电池仍然挂在骑手名下,他再发起换电就进行不下去了。后台留痕还自相矛盾:开仓台账记的是失败,流转记录记的是成功。

影响是这名骑手换不了电。影响范围与最终处理方式没有确认。

本质

一句话:开仓的真实结果是失败,但查这条记录的语句没把结果字段取出来,程序拿到的是空值,而空值被判定成了成功,失败就这样报给了前端。

  1. 每次开仓都会在台账里留下一条记录,orderStatus 是唯一说明这次到底成没成的字段,成功写 0,失败写 1。
  2. 归还非本人电池后,换电流程重新发起开仓,柜子没开成,台账写入 orderStatus = 1。
  3. 后端把这条记录组装成返回结果时,用的查询没把 orderStatus 取出来。字段不在查询列里,对象里就是 null,既不是 0,也不是 1。
  4. 判断逻辑写成「orderStatus 为 null 或为 0 就是成功,其余是失败」。null 顺着这条默认分支滑进了成功,返回给前端的自然就是成功。
  5. 前端按成功继续往下走,失败分支没有机会执行,这次开仓失败的交接始终没被纠正,电池一直挂在用户名下,用户再换电就被挡住。
  6. 于是同一次操作留下两种结论:台账里是真实结果失败,对外返回和流转记录是成功。唯一能暴露问题的字段,恰好就是查询里漏掉的那个字段。

修复方案和上线状态都没有确认。修复方向是:把 orderStatus 加回查询列;判断不再给 null 默认成功,取不到结果就按失败返回并告警;再对已经分叉的台账和流转记录做一次比对,把这批报成功但实际失败的记录捞出来处理。

错误代码

// 开仓结果查询与对外返回(脱敏教学示例)
public OpenResult queryOpenResult(String recordNo) {
    // 为什么错:这条查询没有选 order_status(示例只列了部分列),
    // 数据库里写的 1(失败)根本进不了这个对象
    // select record_no, battery_no, create_time
    //   from t_open_record where record_no = #{recordNo}
    OpenRecord record = openRecordMapper.selectByNo(recordNo);

    // 为什么错:把 null 和 0 一起判成功。字段没查出来时
    // orderStatus 就是 null,真实失败因此走了成功分支
    if (record.getOrderStatus() == null || record.getOrderStatus() == 0) {
        return OpenResult.success(record.getRecordNo());
    }
    return OpenResult.fail(record.getOrderStatus());
}

修复代码示例

// 同一入口:查全字段,空值按失败处理(脱敏教学示例)
public OpenResult queryOpenResult(String recordNo) {
    // 修复:查询列补上 order_status,
    // 让台账里的真实结果能进到对象
    OpenRecord record = openRecordMapper.selectByNo(recordNo);
    if (record == null) {
        return OpenResult.fail(null);      // 记录不存在,不能报成功
    }

    Integer status = record.getOrderStatus();
    if (status == null) {
        // 修复:取不到结果就按失败返回并告警,
        // 不再把「不知道」当成成功
        log.error("open result status missing, recordNo={}", recordNo);
        alert.warn("open_status_missing", recordNo);
        return OpenResult.fail(null);
    }
    // 修复:只认 0 为成功,显式枚举,其余一律失败
    return status == 0
            ? OpenResult.success(record.getRecordNo())
            : OpenResult.fail(status);
}

下次遇到这些场景要警惕

  • 手写 select 或映射组装返回对象时:先把调用方真正会读的字段列出来,和查询列逐项对照;再构造一条 orderStatus = 1 的记录调一次接口,观察返回是成功还是失败,不要只看界面是否报错。
  • 状态判断里出现 null 分支时(例如 null 或 0 判成功):单独构造字段为空的对象跑一遍,确认它落到失败分支。空值默认成功,等于把「不知道」当成了「办成了」。
  • 同一个动作同时有台账和流转两类记录时:抽一批数据比对两边结果字段,任何一条两边结论不同都按数据问题查,别只信对外返回的那一份。
  • 用户反馈「提示成功但事情没办成」时:先去底层记录里核对真实状态,包括那些没被查询出来的列,再判断是前端展示问题还是结果被误判。