发生了什么
用户到换电柜换电,把车上没电的电池取下来,换上一颗满电的电池。换电成功后,系统要登记一条归属关系:这颗电池现在归哪个用户使用、装在哪辆车上。一颗电池同一时间只能有一条有效归属,否则后续换电、计费和调度都不知道这颗电池在谁手里。
正常流程是:换电请求进来,程序先看这颗电池是否已经挂在别人名下,是就拒绝,没有才写入新的归属。车辆信息也能改,但有个限制——车在租赁中,任何信息都不允许修改,要等归还之后才能动。
这次需求放开了限制,允许租赁中的车辆只改车牌号,先在一部分区域灰度。灰度期间出现异常:两名用户几乎同时在同一柜子换电,事后核对发现,同一颗电池在系统里同时挂在两个用户名下。运营据此反馈“同颗电池绑定多用户”,请研发确认原因。
本质
问题出在一次“改车牌”的请求上。
系统里改车辆信息只有一个入口,方法里除了更新车牌,后面还挂着一整套和车辆、电池有关的处理:读这台车的中控编号(标识车上设备的一串编号),判断这台车当前用哪颗电池、这颗电池是否已经有归属,再决定要不要写绑定关系。
数据正常时这套判断够用,因为每台车都有中控编号。但库里有一部分记录这个字段是空的(null)。以前车在租赁中不能改任何信息,这段带判断的老代码在租赁场景下根本不会被执行,空值的问题一直没有暴露。
这次改动只想着“允许改车牌”,实现时复用了这个统一入口:车牌更新完没有在这里结束,继续往下执行老逻辑。于是过程变成:
- 用户提交改车牌,程序进入统一入口,车牌更新成功。
- 程序没有返回,接着读这台车的中控编号,准备做电池归属判断。
- 编号是空的。这行判断没有先校验它是否为空,空值让“这颗电池是否已有归属”的结论落不下来,绑定动作没有被拦住。
- 同一时间另一名用户的换电请求也走到这里,两次绑定都写进了库,同一颗电池便挂到了两个用户名下。
修复做了三件事:把“租赁中只改车牌”拆成单独的方法,处理完直接返回,不再进整车信息更新的老逻辑;给那行判断补上非空校验;再把其它用到中控编号的地方逐一排查,没有发现同类缺失。修复重新发版上线,灰度期间写出的归属数据另行订正。
错误代码
/** 车辆信息变更入口:车牌和后续的电池归属处理都在这里 */
public void changeVehicle(VehicleChangeReq req) {
Vehicle v = vehicleMapper.selectById(req.getVehicleId());
if (req.getPlateNo() != null) {
vehicleMapper.updatePlateNo(v.getId(), req.getPlateNo());
}
// 为什么错:只改车牌的场景没有单独返回,继续执行下面的电池逻辑
bindCurrentBattery(v, req.getUserId());
}
private void bindCurrentBattery(Vehicle v, Long userId) {
String ecuNo = v.getEcuNo();
// 为什么错:没有先判断 ecuNo 是否为空,编号为空时既不命中已有归属,
// 也不会被拒绝,流程直接落到下面的 bind,写入第二条归属
if (ecuNo != null && bindingService.isBoundToOther(ecuNo, userId)) {
return;
}
bindingService.bind(ecuNo, userId, v.getId());
}
修复代码示例
public void changeVehicle(VehicleChangeReq req) {
// 修复一:租赁中的车只改车牌,走独立方法,处理完直接返回
if (req.isRental() && req.onlyPlateChanged()) {
vehicleMapper.updatePlateNo(req.getVehicleId(), req.getPlateNo());
return;
}
Vehicle v = vehicleMapper.selectById(req.getVehicleId());
bindCurrentBattery(v, req.getUserId());
}
private void bindCurrentBattery(Vehicle v, Long userId) {
String ecuNo = v.getEcuNo();
// 修复二:编号为空直接拒绝,不再按“可以绑定”继续往下走
if (ecuNo == null || ecuNo.isEmpty()) {
throw new BizException("车辆设备编号缺失,无法完成电池归属登记");
}
if (bindingService.isBoundToOther(ecuNo, userId)) {
throw new BizException("该电池已归属其他用户");
}
bindingService.bind(ecuNo, userId, v.getId());
}
示例为脱敏教学代码,只保留“改车牌复用整车入口”和“判断缺空值校验”两处机制,不代表实际项目源码。VehicleChangeReq 是车辆信息变更请求,ecuNo 是车辆上的设备编号,bindingService 负责读写电池归属关系。
下次遇到这些场景要警惕
- 给原本完全禁止修改的对象放开某个字段:先列出这个入口后面还挂着哪些后续处理,再用一条真实数据只改这个字段跑一遍,观察有没有多写别的记录。
- 判断里出现“字段为空就跳过”的写法:把它改成“为空就拒绝或明确兜底”,并在代码评审时把这类判断单独标出来。
- 老代码依赖数据库字段做判断:上线前先统计这个字段的空值数量,再造一条空值数据走主流程,确认接口返回的是拒绝而不是成功。
- 换电、租赁这类归属关系:回归时直接查归属表,比较操作前后的记录条数,确认同一颗电池始终只有一条有效归属。