发生了什么

用户在平台上用车前要有一笔押金记录。平台把同一笔押金记在两处:一处挂在商户(提供车辆的合作方)名下,商户后台能看到这条记录,也能替用户发起取消;另一处挂在用户名下,App 里显示的押金状态取自它。取消押金就是把这两条记录都关闭,只关一边,另一边仍处于占用状态。

正常流程是:商户后台发起取消,押金服务先关闭商户侧记录,再按同一个押金单标识(depositId)找到并关闭用户侧记录,两边一起变成已取消。以前这条路径是商户侧代码直接读写用户侧库表,改一处就同时影响两边。

最近一次改造把这条路换成了调用新接口,接口由押金服务提供给商户后台使用,按灰度放量。3 月 20 日晚,一次取消只完成了一半:商户侧显示取消成功,用户侧那条押金记录仍是占用中,用户在 App 里再点取消,系统找不到可以关闭的记录,操作一直卡着,只能找人工处理。当晚后端通过接口手动关闭了这名用户的押金;随后放弃灰度、退回原来的取消逻辑。接口提供方补齐返回数据后,修复版于 3 月 23 日上线。

本质

一句话:取消押金要连改两处记录,第二步靠第一步返回的押金单标识定位;灰度期这个标识没有返回,第二步被跳过,流程仍然报成功。

  1. 原流程里,商户侧代码直接读写用户侧库表,两条记录在同一次操作里改掉,不会出现只改一半的中间状态。
  2. 改造后,商户后台先调用迁移后的接口取消商户侧押金单,接口返回押金单标识,商户后台再拿这个标识去关闭用户侧记录。标识是唯一能定位到那条用户押金记录的入口。
  3. 灰度期间,迁移接口返回的数据里没有这个字段。调用方取到空值,既没有判空也没有中断,继续按「已取消」往下走:用空标识更新用户侧记录,一行都命中不了,影响行数没有检查,日志里只留了一行成功。
  4. 于是两条记录分叉:商户后台这笔押金是已取消,用户名下仍是占用。用户再发起取消时,系统按当前状态找不到待关闭的记录,操作既不成功也不给出新的提示,界面就一直卡住。用户侧读押金状态还会经过一层缓存,记录本身没被关闭,缓存里留着的也还是占用中的值,用户看到的状态和被挡住的行为都来自这份旧状态。

这次修复落在接口返回和调用校验上,已经过去的请求不会因为上线自动重放:灰度窗口内如果还有别的记录只关了一边,要按同样的条件重新查一遍才能确认。长期处理是重新梳理商户押金流程,把两处记录的关闭收拢到一条链路上。

错误代码

// 商户后台的取消押金入口(脱敏教学示例)
public CancelResult cancelDeposit(String merchantId, String userId) {
    // 迁移后的接口:取消商户侧押金单,并返回押金单标识
    CancelResp resp = depositApi.cancel(merchantId, userId);
    merchantDepositRepo.markCancelled(resp.getOrderNo());  // 商户侧先落“已取消”

    // 为什么错:灰度期返回里没有 depositId,
    // 这里不判空就当作一定存在,直接拿来用
    String depositId = resp.getDepositId();

    // 为什么错:空标识更新用户侧记录,一行都命中不了,
    // 返回 0 行既不抛异常,也没人检查
    int closed = userDepositRepo.closeById(depositId);

    // 为什么错:只要调用没抛异常就当成功,
    // 用户侧没关掉也照常返回“取消成功”
    log.info("deposit cancelled, userSideClosed={}", closed);
    return CancelResult.success(resp.getOrderNo());
}

修复代码示例

// 同一入口,改为“用户侧关成功后才把商户侧标成已取消”(脱敏教学示例)
public CancelResult cancelDeposit(String merchantId, String userId) {
    CancelResp resp = depositApi.cancel(merchantId, userId);

    String depositId = resp.getDepositId();
    if (depositId == null || depositId.isEmpty()) {
        // 修复:缺关键标识就中断,商户侧保持原状态,
        // 让操作方看到失败,而不是一条对不上的成功
        throw new DepositCancelException("返回缺少押金单标识,取消未完成");
    }

    // 修复:先关用户侧,并把“影响 0 行”按失败处理
    int closed = userDepositRepo.closeById(depositId);
    if (closed != 1) {
        // 跨服务调用回滚不了,失败要留下可重试的记录供人工核对
        throw new DepositCancelException("用户侧押金记录未关闭,需人工核对");
    }

    merchantDepositRepo.markCancelled(resp.getOrderNo());
    return CancelResult.success(resp.getOrderNo());
}

下次遇到这些场景要警惕

  • 把直读库表改成调用接口:先列出调用方真正用到的每个返回字段,和新接口的返回逐项对照;灰度期用同一笔业务同时跑新旧两条路径,比较两边写出的记录。观察有没有字段在新路径里为空,而代码没有判空就继续用。
  • 一次操作要改两个数据来源:构造一笔取消,改完分别查商户侧和用户侧记录状态;再人为让一侧失败,看会不会留下「一侧已取消、一侧未取消」的记录,以及失败时对外返回的是成功还是失败。
  • 关键标识来自下游返回:检查取值处有没有判空、缺失时是否中断流程;把「更新影响行数为 0」当成失败,不要只捕获异常,否则空值会一路静默走到最后。
  • 用户反馈「取消不了、卡住了」:先按这个用户同时查两侧记录状态,再比对缓存和库里的读取值,确认是记录分叉还是页面问题,不要只在前端重试。