发生了什么
车辆管理是资产侧的一张车辆清单,每台车一条记录,记录上带一个“是否逾期未还”的状态,页面就按这个状态展示。用户为一台车续费套餐,套餐决定这台车在什么时间内可以正常使用:套餐在有效期内,车就是正常可用;套餐到期而车还没有还回来,这台车才会被标成逾期未还。
套餐由服务侧的订单程序维护,车辆状态由资产侧的车辆资产程序维护,两边不是同一份数据。订单程序不直接改资产侧的记录,而是在车辆转为逾期时发一条状态通知,车辆资产程序收到后改对应车辆的状态。正常情况下一台车对应一条通知、只改一条记录。
这套通知设计时,一个用户只绑一台车。后来两条业务线复用同一套履约能力,各自独立下单,订单互相隔离,同一用户可以在不同业务线各有一台车,用户与车辆的绑定关系从一台变成了多台。
这次反馈的用户给其中一台车续费成功,套餐在有效期内,车也能正常使用,但车辆管理里这台车显示逾期未还车。查下来,这个用户名下不止一台车,另一台车到了逾期,订单程序按流程发出了逾期通知。通知到达车辆资产程序后,程序按通知里的用户标识查出这个用户名下绑定的全部车辆,在循环里把每一台都改成了逾期,已经续费的那台也被一起改掉。确认的影响是这部分车辆的管理页状态显示错了,车辆本身的使用不受影响;记录没有给出受影响的用户数量。
这次的处理是补发一条正常状态的车辆套餐消息,把被改错的状态重置回来。长期方案是订单程序在发逾期通知时带上车架号,车辆资产程序按用户标识加车架号定位到唯一一台车,再按原有逻辑处理。该改动是否已经上线、是否验证过,记录里没有说明。
本质
一句话:逾期通知里没有能唯一对应一台车的字段,车辆资产程序只能按用户把处理范围扩大到该用户的全部车辆。
- 订单程序在车辆转为逾期时发通知,消息体里只有一个状态值和一个用户标识,没有车架号。
- 车辆资产程序收到通知,按用户标识查询这个用户绑定的所有车辆。
- 设计时一个用户只绑一台车,查出来的集合只有一条,循环改一条,结果看起来是对的,这个前提掩盖了问题。
- 两条业务线复用履约能力后,订单互相隔离,同一用户可以在不同业务线各有一台车,绑定关系变成多台;消费逻辑仍按用户标识查,集合就变成了多条。
- 循环把集合里每台车辆的状态都写成逾期,页面按车辆记录展示,已续费的那台也显示逾期未还车。
错误不在逾期通知该不该发:那台车确实逾期了,通知应该发。错在通知携带的信息只够定位到人,不够定位到车,而消费端把“这个人名下的车”当成了“这台车”。把用户标识当作更新的唯一定位条件,一次逾期就会把同一用户名下所有车辆一起改掉。
修复方向是通知里补上车架号,消费端按用户标识加车架号取到唯一一条车辆记录再更新。消费端还可以在消息缺车架号时拒收并告警,而不是退回按用户处理整组车辆,这一条是从原因推出的建议,记录里的方案只写了补字段。这次补发一条正常状态消息就能把状态重置回来,也说明消费端本来就是按用户整组改写的。下面两段 Java 代码为脱敏教学示例,用于说明这段消费逻辑怎么定位车辆、修复改在哪,不代表实际项目源码或已上线实现。
错误代码
// 车辆资产程序消费逾期通知:按用户找出绑定车辆后逐台改状态(脱敏教学示例)
public void onVehicleOverdue(OverdueNotice notice) {
// 消息里只有状态值和用户标识,没有车架号
List<Vehicle> vehicles = vehicleRepository.listByUserId(notice.getUserId());
for (Vehicle vehicle : vehicles) {
// 为什么错:查出来的是该用户名下绑定的全部车辆,
// 循环把每一台都改成了同一个逾期状态,已续费的车也被改掉
vehicleRepository.updateStatus(vehicle.getId(), VehicleStatus.OVERDUE);
vehicle.setStatus(VehicleStatus.OVERDUE);
}
}
修复代码示例
// 修复后:通知带车架号,按用户标识加车架号定位唯一一台车(脱敏教学示例)
public void onVehicleOverdue(OverdueNotice notice) {
if (!StringUtils.hasText(notice.getVin())) {
// 缺车架号时拒收并告警,不能退回按用户处理整组车辆
log.warn("overdue notice without vin, userId={}", notice.getUserId());
throw new IllegalArgumentException("vin required");
}
Vehicle vehicle = vehicleRepository.findByUserIdAndVin(
notice.getUserId(), notice.getVin());
if (vehicle == null) {
log.warn("vehicle not found, userId={}, vin={}", notice.getUserId(), notice.getVin());
return;
}
// 更新条件带上车架号,只改这一台车
vehicleRepository.updateStatusByVin(notice.getVin(), VehicleStatus.OVERDUE);
}
下次遇到这些场景要警惕
- 给状态通知增加处理范围时,先列出消息体字段和消费端的查询条件,再构造同一用户两条绑定记录,只让其中一条发生变化,观察另一边是否只改了一条。
- 上线“一个用户可绑定多个资源”这类关系变化时,列出所有按用户维度查询和更新的消费点,逐个确认补上了资源标识;模拟一台资源异常,看同用户其它资源是否被连带改写。
- 排查“已续费仍显示逾期”这类两边状态对不上时,先对比两边的数据来源和通知字段,再重放一次通知,观察实际影响的行数是不是一。
- 用补发消息重置线上错误状态前,先确认消费端的更新范围;按用户批量改写的逻辑,补发也会一并改到同用户的其它记录。