发生了什么
用户在平台上用车前要有一笔押金记录。平台把同一笔押金记在两处:一处挂在商户(提供车辆的合作方)名下,商户后台能看到这条记录,也能替用户发起取消;另一处挂在用户名下,App 里显示的押金状态取自它。取消押金就是把这两条记录都关闭,只关一边,另一边仍处于占用状态。
正常流程是:商户后台发起取消,押金服务先关闭商户侧记录,再按同一个押金单标识(depositId)找到并关闭用户侧记录,两边一起变成已取消。以前这条路径是商户侧代码直接读写用户侧库表,改一处就同时影响两边。
最近一次改造把这条路换成了调用新接口,接口由押金服务提供给商户后台使用,按灰度放量。3 月 20 日晚,一次取消只完成了一半:商户侧显示取消成功,用户侧那条押金记录仍是占用中,用户在 App 里再点取消,系统找不到可以关闭的记录,操作一直卡着,只能找人工处理。当晚后端通过接口手动关闭了这名用户的押金;随后放弃灰度、退回原来的取消逻辑。接口提供方补齐返回数据后,修复版于 3 月 23 日上线。
本质
一句话:取消押金要连改两处记录,第二步靠第一步返回的押金单标识定位;灰度期这个标识没有返回,第二步被跳过,流程仍然报成功。
- 原流程里,商户侧代码直接读写用户侧库表,两条记录在同一次操作里改掉,不会出现只改一半的中间状态。
- 改造后,商户后台先调用迁移后的接口取消商户侧押金单,接口返回押金单标识,商户后台再拿这个标识去关闭用户侧记录。标识是唯一能定位到那条用户押金记录的入口。
- 灰度期间,迁移接口返回的数据里没有这个字段。调用方取到空值,既没有判空也没有中断,继续按「已取消」往下走:用空标识更新用户侧记录,一行都命中不了,影响行数没有检查,日志里只留了一行成功。
- 于是两条记录分叉:商户后台这笔押金是已取消,用户名下仍是占用。用户再发起取消时,系统按当前状态找不到待关闭的记录,操作既不成功也不给出新的提示,界面就一直卡住。用户侧读押金状态还会经过一层缓存,记录本身没被关闭,缓存里留着的也还是占用中的值,用户看到的状态和被挡住的行为都来自这份旧状态。
这次修复落在接口返回和调用校验上,已经过去的请求不会因为上线自动重放:灰度窗口内如果还有别的记录只关了一边,要按同样的条件重新查一遍才能确认。长期处理是重新梳理商户押金流程,把两处记录的关闭收拢到一条链路上。
错误代码
// 商户后台的取消押金入口(脱敏教学示例)
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」当成失败,不要只捕获异常,否则空值会一路静默走到最后。
- 用户反馈「取消不了、卡住了」:先按这个用户同时查两侧记录状态,再比对缓存和库里的读取值,确认是记录分叉还是页面问题,不要只在前端重试。