发生了什么
服务站是线下租还车的门店:用户在门店下单取车,取车前先交一笔押金,押金挂在订单上,作为还车和违约处理时的扣减来源。订单有约定的还车时间,按时还车订单就结束;过了时间没还,订单变成逾期。
逾期订单的处理在后台。运营看到逾期未还的单,可以从押金里扣一笔惩罚金作为违约处理,扣完这笔钱记在一条扣款记录上。扣款也可能需要撤回,所以后台还有一个反向入口:取消扣款。取消扣款要做两件事,把已经扣掉的惩罚金退回押金,并把这条扣款记录置为已取消。扣款和取消扣款是一对动作,一个收、一个退,走的是后台同一个入口。
这套功能原本有一套旧实现。服务站业务后来整体迁到新实现上,订单、押金、扣款都跟着搬了过去。
这次的问题出在迁移之后:一位用户在服务站租的车逾期未还,运营在后台对这笔订单做了押金扣款,之后又点了取消扣款,接口直接报错,取消没有完成。扣款本身是成功的,取消失败发生在扣款之后。
取消没完成以后,这笔惩罚金有没有退回、订单最后怎么处理、一共有多少笔订单遇到同样情况,都没有交代,能确认的是后台的取消扣款入口走不通。
本质
一句话:服务站迁到新实现时,迁移范围只覆盖了“逾期 → 扣押金”这条主流程,“取消扣款 → 退钱”这条反向路径没有一起搬过去,新实现里这半边是空的,后台一取消就在这一步失败。
- 旧实现里两个动作是一对:扣款写一条扣款记录、从押金上减掉惩罚金;取消扣款按同一条记录找到原订单,把惩罚金退回押金,再把记录改成已取消。
- 迁移时,扣款是每天都会走的主流程,验收一定会跑到,所以完整搬了过去;取消扣款只有扣错了才用,属于低频的补正动作,迁移范围里没有它,验收时也就没有走到。
- 新实现接住了扣款,也接住了后台发来的取消请求,但“把惩罚金退回押金”这一步没有对应的实现。请求走到这里没有可执行的分支,只能以异常结束。
- 异常一路往上抛,后台收到的就是一句接口报错:运营无法判断是数据不对、权限不够,还是这个场景根本没人做,重试也不会成功。
漏掉的是一个业务场景,不是一行代码:迁移按“主流程跑得通”验收,反向的取消动作没人走过,上线后被第一次点开就失败。
- 同类风险的根子在验收方式。迁移清单按页面入口和主流程列,而不是按“业务场景 × 正向与反向操作”列;扣款与取消、冻结与解冻、占用与释放这类成对动作,只验一半,另一半就一直停在未实现状态,平时没有流量,被人工操作点到才暴露。
- 处置上给出的结论是已修复,对应的是补上惩罚金退款这条场景。修复何时上线、有没有回放当时失败的订单、其他低频场景是否同样漏迁都没有说明,需要按场景清单再核一遍。
修复方向是:补齐取消扣款里的退款步骤,按扣款记录把惩罚金退回押金,再把记录置为已取消,重复点击不重复退;同时把迁移验收改成按业务场景逐条列,每个场景都跑正向和反向两个动作。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 迁移后的服务站扣款服务(脱敏教学示例)
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);
}
}
下次遇到这些场景要警惕
- 把一块业务迁到新实现时:按业务场景列表验收,而不是按页面入口;每个场景把正向动作和反向动作各走一遍,扣款要试取消扣款,冻结要试解冻,占用要试释放,确认两个方向都能走通。
- 后台有“取消”“撤回”“反处理”这类补正入口时:用一笔刚扣过的真实订单走完整流程,看钱有没有回到押金、扣款记录有没有变成已取消;只看接口有没有返回成功不够。
- 看到“接口报错”而页面没有业务提示时:先在日志里找“未实现”“不支持”这类字样;这类报错多半是分支没写,不是数据问题,重试多少次都不会成功。
- 迁移上线后:拿旧系统的功能清单和新实现逐项对照,重点看低频的人工补正入口;只搬了主流程的实现,在清单上会缺一整块反向动作。