发生了什么

租车业务里,一次用车对应一张主订单,记录从下单、用车到还车的全过程。正常流程是:用户结束用车,系统把主订单状态从"租用中"流转到"已结束";只有到了已结束,费用和滞纳金才进入可退款状态,退款流程才能发起。

另一类用户选的是车电一体套餐:用车的同时租一块可更换电池来驱动车辆。这块电池在系统里是另一张租电订单,需要先激活,才代表电池租约真正开始。也就是说,结束一张这样的订单时,主订单要流转到终态,背后的租电订单得先处于已激活状态。

这次用户走完了还车和结束操作,主订单却停在租用中,一直没有变成已结束,费用和滞纳金也就退不出去,用户为此找到客服反馈。排查后发现两个条件同时成立:订单使用的是车电一体套餐(套餐明细类型为 3 或 4);用车时长超过 24 小时,而套餐激活状态的缓存有效期正好是 24 小时。同时满足这两条的订单,结束操作执行完之后主订单不再流转终态,退款入口始终打不开。

当时的处理是提工单修改数据库,把主订单状态直接改成已结束,订单才进入可退款状态,才能继续给用户退费。记录里提到换电套餐未激活的问题后续再优化,但没有说明优化是否上线、是否验证过。

本质

结束订单的程序在流转状态之前,要先确认车电一体套餐是否已经激活,而这份激活状态是从缓存里读的。问题在于,同一件事在这条路径上写了两套判断,结论正好相反。

  1. 用户下单用车时,系统为车电一体套餐创建了租电订单,但没有完成激活这个动作。
  2. 用车不满 24 小时就结束订单时,缓存还在有效期内,结束程序读到缓存值就直接放行,把主订单改成已结束,退款可以正常发起。
  3. 用车超过 24 小时后缓存过期,结束程序重新查询租电订单,读到的是"未激活",于是走进另一条分支,直接返回。
  4. 这条分支没有写入终态,主订单就停在租用中,后续没有任何环节再把它推进到已结束。
  5. 退款入口只对已结束的订单开放,主订单不在这个范围内,费用和滞纳金也就都退不出去。

所以缺陷有两处,且互相叠加:一是在用车环节漏掉了租电订单的激活,二是结束流程把"套餐是否激活"写成了两套结论——缓存有效就当作已激活并放行,缓存过期就放弃整次流转。缓存有效期本来只是读取性能的折中,在这里却变成了业务分支的开关。

缓存过期只是让程序换了一条分支,真正的问题是这条分支直接放弃状态流转,订单就永久停在中间态。

修复方向是:把套餐状态的读取收敛成一个入口,缓存只做加速、过期就回源,两条路径给出同一个判断;对"未激活"不再直接跳过,而是在结束时幂等补一次激活,补不上就显式失败并告警;同时把激活提前到用车环节,不依赖缓存是否还在。记录中只有改库这一临时处理,因此下面的代码只说明思路。

错误代码

private static final long PACKAGE_TTL_SECONDS = 24 * 60 * 60; // 缓存有效期 24 小时

public void finishOrder(OrderMain main) {
    if (main.isVehicleBatteryBundle()) {          // 车电一体:明细类型 3、4
        PackageState pkg = packageCache.get(main.getPackageId());
        if (pkg == null) {                        // 为什么错:缓存过期后换成了另一套判断
            pkg = packageMapper.selectById(main.getPackageId());
            if (!pkg.isActivated()) {
                return;                           // 为什么错:未激活就直接放弃,终态永远不写
            }
        }
        // 缓存有效时不做激活校验,直接放行;两条分支对同一份数据得出相反结论
    }
    main.setStatus(FINISHED);                     // 只有缓存命中才会走到这里
    orderMainMapper.updateStatus(main.getId(), FINISHED);
    refundService.enable(main.getId());           // 退款入口依赖上面这条终态
}

修复代码示例

public void finishOrder(OrderMain main) {
    if (main.isVehicleBatteryBundle()) {
        // 只保留一个判断入口:缓存只做加速,过期就回源,不再分成两套结论
        PackageState pkg = packageService.loadState(main.getPackageId());
        if (!pkg.isActivated()) {
            // 修复方向:把用车时漏掉的激活补在这里,幂等执行,失败则抛出可观测异常
            packageService.activateIfAbsent(main.getPackageId());
        }
    }
    main.setStatus(FINISHED);
    int updated = orderMainMapper.updateStatus(main.getId(), FINISHED);
    if (updated != 1) {                           // 状态没写成功就不要再放开退款
        throw new IllegalStateException("结束订单状态流转失败: " + main.getId());
    }
    refundService.enable(main.getId());
}

下次遇到这些场景要警惕

  • 状态流转的判断依赖带过期时间的缓存:把缓存命中和缓存未命中当作两个测试用例,分别结束一次订单,观察两条路径写入的终态是否一致;任何一条路径提前返回而没有写终态,都要当成缺陷。
  • 同一业务对象在另一张单据里还有状态:比如租电订单要激活才能用,就在用车环节造一条"只建单、不激活"的数据,等到缓存过期之后再结束订单,确认流程能补齐激活或给出明确失败提示,而不是停在中间态。
  • 退款、结算只处理终态订单:造一笔停在中间态的订单,检查是否有巡检或对账能主动发现;没有的话,这类问题只能等用户投诉才暴露。
  • 用改库处理线上卡单:改库只是把这一单推到终态,处理完要追问为什么没有自动补,并用同样的条件再走一次新订单,确认修复后该路径能自然走完。

文中代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。