发生了什么
这套资产系统管理运营用的两轮电动车。每辆车在系统里有归属城市和所属门店:归属城市决定这辆车算在哪个城市运营,门店是车辆在系统里登记归属的业务单元。车在路面上被骑行、被调度,位置和状态通过心跳持续上报,系统据此把车辆自动归到它当前所在的城市,这个动作叫自动归属。
车辆按业务线归属在不同的业务域下,业务域表示这辆车属于哪条业务线。屏蔽城市配置的作用,是让名单上的城市不参与某条业务域车辆的自动归属。这份配置按业务域分开:每条业务域各有一份城市名单,自动归属前先看车辆属于哪个业务域,读出那份名单,城市在名单里就不改归属。
正常一次自动归属是这样的:车辆上报心跳,程序从心跳里取车辆的业务域,按业务域读出屏蔽城市名单,命中就拦下这次归属,没命中才把车辆归属到上报的城市。
这次的不同在取值来源。产品在另一个需求里取消了车辆的业务域字段,车辆档案不再维护“这辆车属于哪条业务线”,心跳报文里这个字段虽然还在,值已经不能代表车辆真实所属的业务域。屏蔽判断仍然从心跳取业务域,取到的业务域是错的,读出来的是另一条业务线的屏蔽名单。这份名单里没有目标城市,程序判断不需要屏蔽,车辆照常被自动归属进去。
结果就是:多个城市已经配置了屏蔽,名单和配置都在,车辆还是被归了进去。记录没有给出涉及的城市清单和车辆数量,能确认的影响只到“屏蔽配置在这些城市没有拦住自动归属”。
本质
问题不在名单内容,而在查名单之前选错了业务域。
- 屏蔽城市不是一张全局表,而是按业务域分开的多份名单。程序必须先知道车辆属于哪个业务域,才能读到对应的那一份。
- 旧实现从车辆心跳报文里取业务域。车辆的业务域字段还正常维护时,这个取值是准的,选名单没有问题。
- 产品取消车辆业务域字段后,车辆档案不再有这个属性,心跳里的值也不再跟着车辆真实业务线走。字段还留在报文里,含义已经失效,读取方却仍把它当成权威来源。
- 拿到错误的业务域,程序读的是另一条业务线的名单。目标城市不在这份名单里,判断结果自然是不需要屏蔽。
- 判断放行后,自动归属照常执行,车辆被归进本应被屏蔽的城市。
记录给出的修复方向是:先按车辆查出所属门店,用门店档案里登记的业务域去读屏蔽城市名单,再校验是否拦下这次自动归属变更。也就是说,业务域不再从心跳取,改从车辆的登记信息取。修复是否已经上线、上线后是否验证过,记录没有说明,修复上线状态待确认。
下面的代码是脱敏教学示例,用来解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 收到车辆心跳后,判断是否拦下这次自动归属(脱敏教学示例)
public boolean shouldBlockAutoAssign(HeartbeatMsg heartbeat) {
String cityCode = heartbeat.getCityCode();
// 为什么错:业务域取自心跳报文,该字段已随车辆业务域取消而不再维护
String bizDomain = heartbeat.getBizDomain();
// 为什么错:用失效的业务域选名单,会读到另一条业务线的城市名单
List<String> blockedCities = shieldConfig.getBlockedCities(bizDomain);
// 为什么错:名单里没有该城市就放行,选错名单的结果被当成正常判断
return blockedCities.contains(cityCode);
}
public void onHeartbeat(HeartbeatMsg heartbeat) {
if (!shouldBlockAutoAssign(heartbeat)) {
vehicleCityService.autoAssign(heartbeat.getVehicleNo(), heartbeat.getCityCode());
}
}
修复代码示例
// 业务域改为从车辆所属门店取,门店档案是车辆业务线的登记来源
public boolean shouldBlockAutoAssign(HeartbeatMsg heartbeat) {
String cityCode = heartbeat.getCityCode();
StoreInfo store = storeService.getByVehicleNo(heartbeat.getVehicleNo());
if (store == null || store.getBizDomain() == null) {
// 取不到门店或业务域就无法判断;示例按不自动归属处理,避免错归
log.warn("store or bizDomain missing, skip auto assign, vehicle={}", heartbeat.getVehicleNo());
return true;
}
List<String> blockedCities = shieldConfig.getBlockedCities(store.getBizDomain());
return blockedCities.contains(cityCode);
}
public void onHeartbeat(HeartbeatMsg heartbeat) {
if (!shouldBlockAutoAssign(heartbeat)) {
vehicleCityService.autoAssign(heartbeat.getVehicleNo(), heartbeat.getCityCode());
}
}
两段代码只差“业务域从哪来”这一步,其余判断与调用保持一致,方便对照。
下次遇到这些场景要警惕
- 产品要取消或下线某个字段时,先列出所有读它的地方,包括配置键、名单选择、路由和权限判断,逐个确认换成哪个来源;只改写入方、不改读取方,字段会变成“还在但不对”。
- 按业务域、业务线读取配置或名单时,确认业务域来自登记档案(门店、资产档案)而不是上报报文;构造一辆心跳业务域为空、门店业务域为 A 的车,看程序读到的是哪份名单。
- 配置完屏蔽城市或类似名单后,用名单内城市的一辆车触发一次自动归属,确认车辆没有被归属;再拿另一条业务线的同城车辆跑一次,确认没有串到其他业务线的名单。
- 判断取不到业务域的分支,不要静默放行;至少记录车辆和城市并告警,否则“配置存在但从不生效”可以长期没人发现。