发生了什么
换电业务里,电池平时放在电柜的格口里。商户是接入这项业务、在自家门店摆放电柜的商家,门店在业务里叫网点。用户或商户在柜上完成一次换电,柜门打开,取走一块电池、放回一块电池。每发生一次这样的进出柜,系统都要落一条流转记录,写清是哪台电柜、哪块电池、谁操作的,以及这次操作算在哪个业务方名下——业务上把这个业务方叫“归属”。通知程序再按归属找到接收方,把这次变化发出去;商户后台就是靠这条通知和这条记录,看到“电池在什么时候被谁取走了”。
正常流程是:换电开仓、电池离柜 → 流转记录落表,归属写成操作人所属的商户 → 通知按这个商户发出去 → 商户后台看到电池已离柜,流转里能查到这次操作。
这次,一位商户负责人在自己网点的电柜上换电开仓,把一块电池取走了。电池确实已经不在柜里,但后台仍然显示它还在电柜内,商户侧也没有收到任何通知,看不到这次流转。也就是说,从商户的视角看,这次取电池的动作没有发生过。
本质
一句话:落表时系统只用操作人的用户 id 去反查归属,查不到就把归属默认写成“客服代客”,这条记录连同它的通知一起算到了客服代客名下,商户这边既查不到流转,电池也还挂在柜里。
- 归属的来源只有一条:拿操作人的用户 id 去查这个账号属于哪个业务方。用户 id 标识的是操作账号,账号和商户之间的对应关系是另一份数据。
- 这次按这个 id 去查,没有查到对应的商户信息。账号没有登记、绑定关系缺失、查询用错了键,都会造成这个结果,究竟是哪一种,目前无法确认。
- 查询结果为空时,代码没有把它当成一个需要处理的状态,而是走了历史兜底:默认记成客服代客。
- 客服代客本身是一个真实存在的业务方,是客服人员代客操作时的归属。所以兜底写进去以后,这条记录看起来完全合法:有归属、有操作人、有电柜和电池,没有任何地方标明这个归属是猜出来的。以后无论是查数据还是做补偿,都没法把它和真正的客服操作分开。
- 通知按归属投递,接收方跟着变成客服代客,商户不在接收范围里;商户后台按归属查流转,同样查不到这条记录,那块电池的状态就停在“在柜”,和实物对不上。
用“客服代客”接住查不到的归属,比留空更难发现:错误数据从此看起来像正常业务数据。
这个问题目前只标记为已处理,没有说明改了什么、是否已经上线,修复上线状态待确认。修复方向是:把“客服代客”和“归属未知”拆成两种状态——客服在后台替用户操作时,归属仍然写客服代客;查不到归属时写未知、带上操作人和电柜编号,进人工核对队列并告警,不进入正常通知;同时补齐账号到商户的绑定关系;历史数据按“归属是客服代客、但操作人查不到对应商户”这个条件筛出来,逐条核对后重放状态和通知。
下面两段 Java 是脱敏教学示例,只对比归属的确定方式,不代表实际项目源码或已上线实现。
错误代码
public void recordBatteryOut(BatteryOutEvent event) {
// 归属只有一个来源:操作人的用户 id
String ownerCode = userService.findBusinessCode(event.getOperatorUserId());
if (ownerCode == null) {
// 为什么错:查不到归属时借用真实的“客服代客”,错数据从此看起来合法
ownerCode = "CS_ASSIST";
}
BatteryLedger ledger = new BatteryLedger();
ledger.setBatterySn(event.getBatterySn());
ledger.setCabinetNo(event.getCabinetNo());
ledger.setOperatorUserId(event.getOperatorUserId());
ledger.setOwnerCode(ownerCode);
ledgerRepository.save(ledger); // 这条记录记到了客服代客名下
// 为什么错:通知按归属找接收方,商户不在接收范围里
notifyService.send(ownerCode, event);
}
修复代码示例
public void recordBatteryOut(BatteryOutEvent event) {
Optional<BusinessOwner> owner = userService.findBusinessOwner(event.getOperatorUserId());
BatteryLedger ledger = new BatteryLedger();
ledger.setBatterySn(event.getBatterySn());
ledger.setCabinetNo(event.getCabinetNo());
ledger.setOperatorUserId(event.getOperatorUserId());
if (owner.isPresent()) {
ledger.setOwnerType(OwnerType.BUSINESS);
ledger.setOwnerCode(owner.get().getCode());
} else {
// 查不到归属时写“未知”,不再借用真实的客服代客
ledger.setOwnerType(OwnerType.UNKNOWN);
ledger.setPendingReason("OPERATOR_OWNER_NOT_FOUND");
}
ledgerRepository.save(ledger);
if (ledger.getOwnerType() == OwnerType.UNKNOWN) {
// 未知归属进人工核对队列并告警,不按普通通知静默发出
ownerReviewQueue.submit(ledger);
} else {
notifyService.send(ledger.getOwnerCode(), event);
}
}
下次遇到这些场景要警惕
- 给流转记录加“归属/业务方”字段时:先列出这个字段所有可能的取值来源,再构造“操作人账号查不到归属”的数据完整跑一次,检查结果是被标记为未知并进入人工队列,还是被写成一个看起来正常的业务方。
- 代码里准备写兜底值时:先确认这个兜底值是不是真实的业务取值。如果它本身就是某个业务方,就换成专门的“未知/待归属”状态,并用一条查询验证两类记录能分开。
- 通知按归属投递时:用归属未知的记录发一次,检查系统是告警并转人工,还是既没有发给商户、也没有人跟进;不要只看日志里的“发送成功”。
- 修历史数据时:先按兜底值加操作人反查不匹配筛出可疑记录,逐条核对归属后再重算状态和通知,避免把真实的客服代客操作记录一起改掉。