发生了什么
租车业务里,每辆运营车辆上装着一个智能控制模块,业务上叫智能芯。它有一串出厂编号,登记在车辆档案里叫中控编号;一辆车同一时间只对应一颗智能芯。装车、拆下或更换设备时,设备和车辆的对应关系要跟着变:车辆基础平台完成解绑后会发出一条中控解绑消息,租车这边有程序监听这条消息,负责把系统里的绑定关系改掉。
系统里这段绑定关系存了两份。车辆信息表在车辆那一行记着当前的中控编号;智能芯信息表在设备那一行记着当前绑定的车架号,还记了绑定时间。后台有两个页面分别读这两张表:车辆管理页面看车,显示中控编号;智能芯管理页面看设备,显示绑定车架号和绑定时间。正常解绑之后,两边应当同时变空——车辆管理里这台车没有中控编号,智能芯管理里这颗设备显示未绑定。
这次的现象是两边对不上。某颗智能芯在智能芯管理页面显示已绑定某台车,还带着之前装车时的绑定时间;同一台车在车辆管理页面里,中控编号却是空的。也就是说,设备这一侧仍然认为它装在那辆车上,车辆那一侧已经不认这颗设备了。反馈来自服务群,随附两张页面截图,页面上没有报错提示。
处理分两步:先用脚本把已经不一致的数据订正过来;长期改法是让监听解绑消息的程序在清空中控编号之外,再调用智能芯自己的解绑接口。记录没有写这类数据有多少条、也没有写长期修复是否已经上线验证。
本质
解绑消息本身到达了,处理它的程序也没有报错,问题出在这次处理只改了两份副本中的一份。
- 车辆基础平台解绑完成后,发出中控解绑消息,消息里带着这辆车和这颗设备的信息。
- 租车这边的监听程序收到消息,做了一件事:把车辆信息表里这台车的中控编号改成空。这一步是成功的,所以车辆管理页面看上去已经解绑。
- 智能芯信息表那一份没有任何人动。这项更新写在智能芯模块自己的解绑接口里,监听程序没有依赖也没有调用它;设备行上的绑定车架号还是这辆车,绑定时间也还是原来那次装车的时间。
- 两个页面各读一张表,于是给出相反的答案:车辆页说这台车没有设备,设备页说这颗设备装在这台车上。同一段关系出现两个版本,谁对谁错只能靠人工核对。
- 更新范围的不对称从数据上也能看出来。装车那次两张表都写上了,否则设备页不会有绑定车架号和绑定时间,车辆页在被清空之前也不会有一串中控编号;解绑这次只写了一张。绑定和解绑改的是同一段关系,覆盖的副本却不一致,副本从此分叉。
同一段绑定关系在两处各存一份,解绑时只清了一处,两个页面就会长期对不上,而消息已经正常消费,没有重试会把漏掉的这次写入补回来。
修复方向是:监听程序在清空中控编号之外,补上智能芯解绑接口的调用,按车架号和设备号都能解,并做成幂等,重复消费不报错;已经分叉的存量数据用两表比对脚本订正。这里还有个边界要注意:先改本地表、再调远端接口,远端失败时同样会留下只改一半的状态,所以解绑接口失败必须让消息重试,重试到上限要有告警或对账兜底,不能吞掉异常按成功确认;数据库事务也回滚不了远端调用。
下面的代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 中控解绑消息监听(脱敏教学示例)
public class EcuUnbindListener {
private final VehicleMapper vehicleMapper;
// 智能芯信息表有自己的解绑接口,这个类没有依赖它,也就不会调用
public void onMessage(EcuUnbindMessage msg) {
// 车辆表:把这台车的中控编号清空,车辆管理页面据此显示“未绑定”
vehicleMapper.clearEcuNo(msg.getVehicleNo());
// 为什么错:智能芯信息表里同一段关系还写着“绑定这台车”,
// 绑定时间也留在原处,设备页因此仍显示已绑定
// 为什么错:两份副本只改了一份,解绑只走了一半;
// 消息随后正常确认,漏掉的这次写入不会有重试来补
log.info("ecu unbind done, vehicle={}", msg.getVehicleNo());
}
}
修复代码示例
// 同一段解绑逻辑:两份副本一起改,远端失败可重试
public class EcuUnbindListener {
private final VehicleMapper vehicleMapper;
private final SmartChipClient smartChipClient; // 智能芯台账的解绑接口
public void onMessage(EcuUnbindMessage msg) {
// 先解智能芯:按车架号幂等,本来就没绑定也返回成功,重复消费不报错
boolean chipUnbound = smartChipClient.unbindByVehicleNo(msg.getVehicleNo());
if (!chipUnbound) {
// 远端没解成功就抛出,让消息重试;此时车辆表还没清,两份仍都是绑定态
throw new RetryableException("smart chip unbind failed, " + msg.getVehicleNo());
}
// 智能芯已解绑,再清车辆表的中控编号,两份副本落到同一个结论
vehicleMapper.clearEcuNo(msg.getVehicleNo());
}
}
下次遇到这些场景要警惕
- 同一个对象维护了两份记录时:先列出这段关系的所有副本,以及分别读它们的页面和接口,再对照绑定、解绑两条路径各自的更新范围;跑一次解绑,确认两张表同时变,而不是只看车辆页。
- 给消息监听新增或修改处理逻辑时:把“这条消息应当产生哪些写入”写成清单逐项核对;监听类没有依赖的接口不会自动被调用,缺的就是这一类调用。
- 消费逻辑里要调远端接口时:构造一次接口超时或返回失败的输入,确认消息会重试或留下可对账的中间状态,而不是本地改完就确认消息。
- 修好监听之后:先按两张表比对出存量差异,脚本订正完再放量;只改监听不会让已经分叉的数据自己恢复。