发生了什么
服务站车电一体订单,是用户在线上下单、再到线下服务站取车的一类租赁订单,车和电池一起租。订单有明确的状态:下单支付后进入“待取车”,用户到站取车后才进入用车阶段;还在“待取车”时,用户可以在用户端自己取消。这类订单要交一笔押金,押金在系统里不只是一笔钱,还要在用户名下登记一条“押金凭证”——记录这笔押金由哪张订单占用、当前是否还被占用。订单取消时,除了把押金退回去,这条凭证也要收回(关闭),用户名下才不会一直挂着这笔押金。
这笔订单的押金支付方式是信用免押:用户不付现金,由第三方支付渠道按信用占用一份额度,取消或退还时再调它的“解冻”接口把额度释放。免押不等于没有押金,只是押金由现金变成了第三方侧的一份占用。
正常的取消流程是一条顺序链:用户点取消 → 订单程序校验订单仍在“待取车” → 调押金程序退押金,信用免押走第三方解冻 → 解冻成功后,押金程序收回用户侧押金凭证,订单变成已取消。
2025 年 1 月,一名用户取消了一张待取车的订单。前面几步都执行了:第三方侧的解冻实际已经成功,额度已经释放;但这次解冻调用返回的是“系统异常”。订单程序把这个异常当成解冻失败,退押金流程就地中断,最后一步收回用户侧押金凭证没有执行。
结果是一边已放开、一边还留着:订单一侧取消了,第三方侧也解冻了,用户名下这条押金凭证仍然没被收回。最后是人工修改数据把凭证收回。记录只写到处置方式是手动修复数据,没有给出代码层面的改动。
本质
一句话:第三方解冻返回的系统异常只说明“这次操作结果未知”,程序却把它当成“确定失败”,中断了整条退押金流程,后面本可以独立完成的本地收回被一起跳过了。
- 原流程怎么排的。退押金是一条顺序链:先调第三方解冻,正常返回之后才收回本地押金凭证。前后两步绑在同一条链上,前一步不返回成功,后一步就不执行。
- 第三方这次实际做了什么。解冻请求被受理并执行成功,占用已经释放;只是这次调用的返回是系统异常,没有带回成功结果。
- 程序怎么理解这个返回。捕获到异常后按“解冻失败”处理,直接结束退押金流程:没有回查解冻到底有没有生效,也没有把本地凭证的收回拆出来做补偿。
- 为什么长期不一致。远端状态已经变了,本地凭证还在占用,中间没有任何自动对账去发现这处差异,只能等人发现再改数据。
- 处置与修复方向。这次是人工改数据,属于临时处理,不是永久修复。修复方向是:把“结果未知”和“确定失败”分开,异常时先记一条待确认、按订单号回查解冻结果;本地凭证的收回不要被远端异常整段跳过,可以在远端异常时也照常收回、留待回查;再加一条对账,扫“订单已取消但押金凭证未收回”的记录。记录没有给出代码改动,修复上线状态待确认。
第三方返回异常不等于操作没生效:把它当成确定失败,就会一边已经放开、一边还留着占用。
错误代码
// 取消待取车订单时的退押金(脱敏教学示例)
public void cancelOrder(String orderNo) {
Order order = orderRepository.get(orderNo);
if (!"WAIT_PICKUP".equals(order.getStatus())) {
throw new BizException("当前状态不可取消");
}
orderRepository.updateStatus(orderNo, "CANCELED");
try {
// 信用免押:调第三方解冻,释放押金占用
depositClient.unfreeze(order.getDepositNo());
} catch (RemoteException e) {
// 为什么错:第三方返回系统异常只代表结果未知,这里当成确定失败
// 为什么错:直接抛出结束整条流程,后面的收回动作被跳过
throw new BizException("退押金失败,请稍后重试", e);
}
// 为什么错:这行只有解冻“正常返回”才会执行,而远端此时可能已经解冻成功
depositVoucherService.revoke(order.getUserId(), order.getDepositNo());
}
修复代码示例
// 修复:结果未知不再当成失败,本地收回与远端调用解耦(脱敏教学示例)
public void cancelOrder(String orderNo) {
Order order = orderRepository.get(orderNo);
if (!"WAIT_PICKUP".equals(order.getStatus())) {
throw new BizException("当前状态不可取消");
}
orderRepository.updateStatus(orderNo, "CANCELED");
try {
depositClient.unfreeze(order.getDepositNo());
} catch (RemoteException e) {
// 修复:只记待回查,不判定为失败,也不中断后面的本地收回
log.warn("解冻结果未知,待回查 orderNo={}", orderNo, e);
depositCompensationService.markUnfreezeUnknown(orderNo, order.getDepositNo());
}
// 修复:凭证收回照常执行,差异交给回查与对账收口
depositVoucherService.revoke(order.getUserId(), order.getDepositNo());
}
两段代码改的是同一处:错误版把第三方异常当成解冻失败并中断,修复版把异常降级为“待回查”,让本地凭证收回不再依赖远端调用是否正常返回。回查确认确实没解冻时再补一次解冻、确认已解冻则关掉待确认记录;这属于从原因推导的方向,记录只确认了人工改数据,没有证据表明这些改动已经上线或验证过。
下次遇到这些场景要警惕
- 对接第三方“解冻、解约、退款”这类释放动作时:先看异常分支怎么走,用挡板或改返回码构造一次“对方实际成功、我方收到系统异常”,观察本地后续步骤是否还会执行、有没有留下待回查记录。
- 把远端调用和本地状态更新串成一条链时:逐步列出每一步失败后本地会停在什么状态,重点找“远端已成功、本地还没更新”的中间态;确认每个中间态都有回查或对账能走回来,而不是等人发现。
- 人工修完一次数据之后:按同一时间段统计“订单已取消但凭证未收回”的记录还有多少条,先分清是单条还是成批,再决定要不要跑一次补偿,别只修被反馈的这一条。
- 评审异常分支时:把第三方的成功、失败、超时、系统异常四种返回逐个走一遍,确认后三种没有被统一当成“确定失败”;超时和系统异常应当按结果未知处理。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现;类名、方法名、状态值均为示意。