发生了什么
换电业务里,用户可以从换电柜借出一颗电池,用完再把电池放回柜子归还。系统里有两份互不替代的数据:一份是绑定关系,记录这颗电池此刻登记在哪个用户名下,客服工具查“电池在谁手里”读的就是这一份;另一份是流转记录,按时间顺序追加每一次借出、归还、取走的动作,只说明发生过什么,不表示当前归属。
正常归还的流程是:用户把电池放进柜子,柜子读到电池编号,系统核对这颗电池是不是这个人借出去的;核对通过,柜门关闭、绑定关系解除、流转记录写一条“已归还”,两边都能查到结果。核对不通过,系统拒绝归还——这是为了防止有人把别人名下的电池塞进柜子抵账。但电池此时已经放进柜子了,被拒绝之后,用户通常又会把它取走。
这次是一位用户来电:流转记录里能看到有人领走了某颗电池,客服工具却查不到这颗电池现在在谁手里。已确认的动作有三条:运营在后台手工把这颗电池从原用户名下解绑;同一天稍晚,流转记录显示这颗电池被一位用户在柜子里取走;三周后,另一位用户尝试把这颗不属于自己的电池归还进柜,归还被拒绝,随后把电池带走。最终电池在第三位用户手上,客服工具里却没有对应的绑定记录。
本质
一句话:归还被拒绝之后电池仍然离柜,这条路径没有写下“电池现在跟着谁”,流转记录和归属查询就从此分开。
-
正常归还走的是“校验通过”那一侧:关柜门、解除绑定、写流转记录,三件事一起完成,两边数据自然一致。
-
非本人电池走的是“校验不通过”那一侧。程序在这里只做了一件事——拒绝归还并给出提示。柜门此前已经打开,电池实际被用户拿走,但代码没有在任何地方记录“这颗电池现在在谁手里”。
-
绑定关系是客服工具的唯一数据源。它停留在“没有绑定”这个状态上,而电池早已被带出柜子,于是客服按编号查出来是空的。
-
流转记录是按动作逐条追加的日志,只要动作发生过就留一条,不依赖绑定关系是否存在。它如实记下了取走这件事,却回答不了“现在归谁”。同一颗电池,在流转记录里有主人,在归属查询里没有主人。
-
更早那次人工解绑,让这颗电池在这之前就已经没有归属记录;归还被拒这一次同样没有把它补回来。两次动作单独看都能解释自己,合起来的结果是这颗电池在系统里一直没有主人,直到用户来咨询才被发现。
产品侧已确认这是方案缺口:归还非本人电池、用户取走电池后没有更新绑定关系。需求已提交、尚未排期,没有已上线修复。修复方向是:归还被拒、电池离柜时同样写一次持有关系,标记为“归还被拒后带走”,或至少把电池置为“柜外待确认”并进入人工处理队列,让客服查得到;再用流转记录回填历史上缺失的持有关系。这种持有关系算不算用户欠费、按什么规则认定,需要产品另行明确,本文只解决“查不到在谁手里”。
代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 归还入口:用户把电池放进柜子后校验归属(脱敏教学示例)
public ReturnResult returnBattery(long userId, String cabinetId, String batterySn) {
Binding binding = bindingRepo.findActiveByBattery(batterySn);
if (binding == null || binding.getUserId() != userId) {
// 为什么错:只拒绝了归还,没有记录电池此刻已被用户取走。
// 柜门早已打开,电池离开柜子这个事实在系统里没有任何落点
return ReturnResult.reject("非本人电池,无法归还");
}
// 只有校验通过的分支才关柜门、解绑、写流转
cabinetService.closeDoor(cabinetId);
bindingRepo.release(userId, batterySn);
flowLogRepo.append(batterySn, userId, Action.RETURNED);
return ReturnResult.ok();
}
修复代码示例
// 同一入口:失败分支也要落一次“电池已离柜”的事实(脱敏教学示例)
public ReturnResult returnBattery(long userId, String cabinetId, String batterySn) {
Binding binding = bindingRepo.findActiveByBattery(batterySn);
if (binding == null || binding.getUserId() != userId) {
// 修复:电池被取走这件事先记进流转,再把持有关系改成实际持有人,
// 客服工具按编号查时就不会是空的
flowLogRepo.append(batterySn, userId, Action.RETURN_REJECTED_TAKEN);
bindingRepo.upsertHolder(batterySn, userId, HolderSource.RETURN_REJECTED);
// 修复:把柜外待确认的电池抛给人工,避免长期没人跟
alertService.warn("非本人电池归还被拒后离柜, sn=" + batterySn);
return ReturnResult.reject("非本人电池,无法归还");
}
cabinetService.closeDoor(cabinetId);
bindingRepo.release(userId, batterySn);
flowLogRepo.append(batterySn, userId, Action.RETURNED);
return ReturnResult.ok();
}
下次遇到这些场景要警惕
- 凡是“校验不通过、但东西已经离柜”的分支:把归还、领取、取件这类接口的失败原因全列一遍,逐条问一句此刻物体在哪。用一颗非本人电池触发归还失败并把它带走,再按编号查归属,看能不能查到。
- 同一对象有两份数据、一份记事实一份记状态:先写清页面和客服工具读的是哪一份,再构造一次只写事实、不写状态的操作,确认两边会不会对不上;能对上之前不要只修展示层。
- 人工解绑、人工改归属这类后台动作:操作完成后立刻查一次客服工具,确认这颗电池是“在柜内”还是“在柜外无持有人”。解绑成功不等于这件事结束。
- 用户来问电池在谁手里:先用流转记录最后一条离柜动作定位实际持有人,再决定补绑还是发起回收,不要只按客服工具的空白结果回答“查不到”。