发生了什么
租车业务里有两份互不相同的记录。一份是订单:记录哪位用户租了哪辆车、约定什么时候归还、当前处于租用中还是已逾期未还车。另一份是车辆资产台账,业务里叫“车基数据”:记录每辆车此刻是什么状态,比如空闲待租、在租未逾期、逾期未还车、维修中,运营据此安排调度和催收。商家端的车辆管理页显示的就是这份台账里的状态,面向商家的租车后台也是从资产侧同步台账得到的;订单详情页读的则是订单自己的状态。
两份记录平时由消息串起来。订单发生起租、续租、逾期、还车等变化时,租赁平台把变化以消息发给资产侧,资产侧收到后更新台账上这辆车的租赁状态,车辆管理和订单详情于是显示同一个结果。资产侧自己不判断订单该不该逾期,它只跟着收到的消息走。
这次核查到的两辆车,在车辆管理里停在“在租未逾期”,而同一辆车的订单详情已经是“逾期未还车”,两个入口给出相反的结论。区域运营把车辆编码和订单截图一起报了上来,资产侧核查后回复:没有收到这些订单的逾期消息。
差异出在平台迁移。租车业务的订单从旧流程迁到新的大租赁平台。从页面状态看,起租这一步仍然是通的——资产侧知道这辆车在租,否则不会显示“在租未逾期”;缺的是起租之后的几类变化:逾期、续租、还车没有继续发到资产侧。订单侧超过约定归还时间未还,订单状态照常改成“逾期未还车”,订单详情因此是对的;资产侧台账没人动,就一直停在最后一次更新时的“在租未逾期”。
本质
问题不在于资产侧把状态改错了,而在于其中一处页面依赖的状态来源从来没有人更新。按实际顺序是这样的:
- 新平台建设时,团队已经梳理到订单状态变化需要发给资产侧的这条消息主题,资产侧开发人员评估后认为这类消息不需要额外处理,业务和产品拉通后决定新平台暂不处理、后续再规划建设。
- 因此新平台上线后,发送侧只覆盖了起租这一步,逾期、续租、还车三类事件没有对应的发送逻辑,不会产生任何消息。
- 订单侧不受影响:用户超期未还,订单状态改为“逾期未还车”,订单详情按订单状态展示,显示是正确的。
- 资产侧没有收到逾期消息,台账里这辆车的租赁状态停在最后一次更新时的“在租未逾期”;车辆管理和租车后台读的是台账,于是也跟着显示“在租未逾期”。
- 两边都没有报错。没有异常日志、没有消息积压、没有重试失败——因为消息根本没有被生产出来,监控上看不到任何异常。这类缺口通常要靠订单与台账对账才能发现。
最终结果是同一辆车在两处显示相反状态。说到底是一处展示所依赖的状态来源被整体漏掉,而不是某条数据被改坏。补发消息只能让之后的变化重新同步;已经逾期的存量车辆如果只靠消息,不会再触发一次更新。
修复方案是在原消息主题上补上逾期、续租、还车三类同步,改动已经上线。已逾期车辆的历史状态是否随之订正,尚未确认。
下面两段是脱敏教学示例,用于说明错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 新租赁平台的订单变更发送器(脱敏教学示例)
class LeaseEventSender {
void onOrderChanged(OrderEvent event) {
switch (event.getType()) {
case "RENT_OUT": // 起租:唯一实现了的一类
mq.send(topic, buildRentOutMsg(event));
break;
// 为什么错:逾期、续租、还车没有分支,
// 直接落到 default 被当作无关事件丢掉,
// 资产侧永远收不到,台账状态停在“在租未逾期”
default:
log.info("ignore event {}", event.getType());
return;
}
}
}
修复代码示例
class LeaseEventSender {
// 与资产侧约定的一对一映射:订单事件 -> 给对方的消息
private static final Map<String, Function<OrderEvent, AssetMsg>> HANDLERS = Map.of(
"RENT_OUT", LeaseEventSender::buildRentOutMsg, // 起租
"OVERDUE", LeaseEventSender::buildOverdueMsg, // 逾期
"RENEW", LeaseEventSender::buildRenewMsg, // 续租
"RETURN", LeaseEventSender::buildReturnMsg); // 还车
void onOrderChanged(OrderEvent event) {
Function<OrderEvent, AssetMsg> handler = HANDLERS.get(event.getType());
if (handler == null) {
// 未登记的事件类型直接失败,不能再静默丢弃
throw new IllegalStateException("未登记的资产同步事件: " + event.getType());
}
mq.send(topic, handler.apply(event));
}
}
三类事件补齐之后,资产侧台账才会跟着订单一起走。已经逾期的存量车辆还需要一次状态回填,并抽查车辆管理里是否已改为逾期未还车。
下次遇到这些场景要警惕
- 订单系统迁移或新建平台:把订单的所有状态变化列成清单(起租、续租、逾期、还车、取消等),逐项到发送侧确认有没有对应消息;再在测试环境制造一次逾期和一次续租,看资产侧台账是否跟着变。
- 同一业务状态出现在两个页面上:先弄清两个入口各读哪张表或哪个服务,再让其中一处故意落后,观察有没有对账或一致性校验能发现;只在页面上点一遍,看不出“消息从来没发”。
- 发送侧处理事件类型:不要用 default 静默忽略未知类型,应当报错或告警,否则以后新增状态还会漏同一处。
- 补发消息上线后:单独核对存量数据,抽查已逾期车辆在车辆管理里是否已变成逾期未还车,不能只验证新产生的订单。