发生了什么

服务站是线下租还车的门店:用户在门店下单取车,取车前先交一笔押金,押金挂在订单上,作为还车和违约处理时的扣减来源。订单有约定的还车时间,按时还车订单就结束;过了时间没还,订单变成逾期。

逾期订单的处理在后台。运营看到逾期未还的单,可以从押金里扣一笔惩罚金作为违约处理,扣完这笔钱记在一条扣款记录上。扣款也可能需要撤回,所以后台还有一个反向入口:取消扣款。取消扣款要做两件事,把已经扣掉的惩罚金退回押金,并把这条扣款记录置为已取消。扣款和取消扣款是一对动作,一个收、一个退,走的是后台同一个入口。

这套功能原本有一套旧实现。服务站业务后来整体迁到新实现上,订单、押金、扣款都跟着搬了过去。

这次的问题出在迁移之后:一位用户在服务站租的车逾期未还,运营在后台对这笔订单做了押金扣款,之后又点了取消扣款,接口直接报错,取消没有完成。扣款本身是成功的,取消失败发生在扣款之后。

取消没完成以后,这笔惩罚金有没有退回、订单最后怎么处理、一共有多少笔订单遇到同样情况,都没有交代,能确认的是后台的取消扣款入口走不通。

本质

一句话:服务站迁到新实现时,迁移范围只覆盖了“逾期 → 扣押金”这条主流程,“取消扣款 → 退钱”这条反向路径没有一起搬过去,新实现里这半边是空的,后台一取消就在这一步失败。

  1. 旧实现里两个动作是一对:扣款写一条扣款记录、从押金上减掉惩罚金;取消扣款按同一条记录找到原订单,把惩罚金退回押金,再把记录改成已取消。
  2. 迁移时,扣款是每天都会走的主流程,验收一定会跑到,所以完整搬了过去;取消扣款只有扣错了才用,属于低频的补正动作,迁移范围里没有它,验收时也就没有走到。
  3. 新实现接住了扣款,也接住了后台发来的取消请求,但“把惩罚金退回押金”这一步没有对应的实现。请求走到这里没有可执行的分支,只能以异常结束。
  4. 异常一路往上抛,后台收到的就是一句接口报错:运营无法判断是数据不对、权限不够,还是这个场景根本没人做,重试也不会成功。

漏掉的是一个业务场景,不是一行代码:迁移按“主流程跑得通”验收,反向的取消动作没人走过,上线后被第一次点开就失败。

  1. 同类风险的根子在验收方式。迁移清单按页面入口和主流程列,而不是按“业务场景 × 正向与反向操作”列;扣款与取消、冻结与解冻、占用与释放这类成对动作,只验一半,另一半就一直停在未实现状态,平时没有流量,被人工操作点到才暴露。
  2. 处置上给出的结论是已修复,对应的是补上惩罚金退款这条场景。修复何时上线、有没有回放当时失败的订单、其他低频场景是否同样漏迁都没有说明,需要按场景清单再核一遍。

修复方向是:补齐取消扣款里的退款步骤,按扣款记录把惩罚金退回押金,再把记录置为已取消,重复点击不重复退;同时把迁移验收改成按业务场景逐条列,每个场景都跑正向和反向两个动作。

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

错误代码

// 迁移后的服务站扣款服务(脱敏教学示例)
public class StationPenaltyService {

    // 迁移时完整搬过来的部分:订单逾期未还,从押金扣一笔惩罚金
    public void deductOverduePenalty(String orderNo, long amount) {
        PenaltyDeduction d = PenaltyDeduction.overdue(orderNo, amount);
        deductionRepo.insert(d);
    }

    // 为什么错:取消扣款要把惩罚金退回押金,这条退款路径
    // 没有随扣款一起迁过来,新实现里是空的
    public void cancelDeduction(String deductionNo) {
        // 为什么错:后台一点取消就走到这里,没有任何退款动作,
        // 直接抛异常,运营看到的就是一句“接口报错”
        throw new UnsupportedOperationException("cancel refund not migrated");
    }
}

修复代码示例

public class StationPenaltyService {

    public void deductOverduePenalty(String orderNo, long amount) {
        PenaltyDeduction d = PenaltyDeduction.overdue(orderNo, amount);
        deductionRepo.insert(d);
    }

    public void cancelDeduction(String deductionNo) {
        PenaltyDeduction d = deductionRepo.get(deductionNo);
        if (d == null || d.isCancelled()) {
            // 已取消或不存在时给出明确业务错误,避免重复退款
            throw new BizException("无效的扣款记录");
        }
        // 补齐迁移漏掉的退款:把惩罚金退回押金
        depositAccount.returnPenalty(d.getOrderNo(), d.getAmount());
        // 退款成功后再置为已取消,重复点击不会退第二次
        deductionRepo.markCancelled(deductionNo);
    }
}

下次遇到这些场景要警惕

  • 把一块业务迁到新实现时:按业务场景列表验收,而不是按页面入口;每个场景把正向动作和反向动作各走一遍,扣款要试取消扣款,冻结要试解冻,占用要试释放,确认两个方向都能走通。
  • 后台有“取消”“撤回”“反处理”这类补正入口时:用一笔刚扣过的真实订单走完整流程,看钱有没有回到押金、扣款记录有没有变成已取消;只看接口有没有返回成功不够。
  • 看到“接口报错”而页面没有业务提示时:先在日志里找“未实现”“不支持”这类字样;这类报错多半是分支没写,不是数据问题,重试多少次都不会成功。
  • 迁移上线后:拿旧系统的功能清单和新实现逐项对照,重点看低频的人工补正入口;只搬了主流程的实现,在清单上会缺一整块反向动作。