发生了什么
门店是租车业务里管车的地方:一辆车平时挂在某一家门店名下,由这家门店负责取车、还车和日常调度。门店分几种类型——服务站是有固定场地、能收车也能发车的门店;服务中心是这次需求新增的一类,业务上要求它具备和服务站一样的能力;提车点是挂在某家门店下面的取还位置,本身不独立经营。每家服务站和服务中心都归属于一个经营商户,一个商户名下可以有多家门店。
车辆调拨指的是把一辆车从一家门店划到另一家门店。门店人员在商家端应用里打开车辆调拨,新建一张调拨单,先选调出门店,再从下拉列表里选调入门店,提交后这辆车的归属就从调出方改成调入方。调入门店不是随便哪家都能选,候选范围是「同一个经营商户名下的门店」再加上「调出门店自己挂的提车点」——车只能在同一个商户内部流转,跨商户不能调。
9 月 18 日,服务中心这个门店类型全量上线。上线后门店人员建调拨单时,发现调入门店的下拉列表不对:调出门店选服务站,列表里只剩服务站和提车点;调出门店选服务中心,列表里只剩服务中心和提车点。服务站和服务中心互相选不到对方,跨这两种类型的车辆调拨做不了。9 月 19 日下午反馈,9 月 22 日晚上发布修复。
本质
一句话:查询调入门店时,限定条件写成了「和调出门店同一类型」;这个限定在只有一种门店类型时恰好等于「同一经营商户」,新增服务中心之后就变成了「另一类门店一个都查不到」。
- 原流程。门店类型只有服务站时,调入门店的查询是「同一经营商户 + 同一种门店类型」。因为该商户名下的门店本来就都是服务站,这两条限定查出来是同一批数据,类型那一条从来没有单独起过作用。
- 这次改动。新增服务中心时,业务要求它的能力和服务站一致,程序里每新增一种门店类型都要实现一份门店处理能力,其中就包含车辆调拨。研发参照服务站的写法实现了服务中心:调出门店是服务中心时,调入门店只查该商户名下的服务中心,再补上调出服务中心自己的提车点。
- 出错点。真正要表达的是「同一个经营商户名下的可调拨门店」,代码写成了「和调出门店同类型的门店」。类型被当成了归属关系的替身——旧逻辑里两者碰巧等价,多出一种类型后就不再等价。
- 结果。服务站调出时只查到服务站,服务中心调出时只查到服务中心,两个方向的候选列表都缺了对方,跨类型的调拨单建不出来。
- 为什么没被拦住。需求文档只写了服务中心要具备归属服务站的能力,没有提车辆调拨;研发知道这次改动会碰到调拨,但没有和产品确认要不要改、改成什么样,也没有同步测试回归。测试按需求文档验收服务中心本身,调拨不在验收范围里,跨类型这条路径上线前没有跑过。
类型限定和归属限定在只有一种类型时看起来一样,多出一种类型的那天,它们就分开了。
修复方向是:调出门店是服务站或服务中心时,可调入门店统一查该经营商户名下的服务站和服务中心,再补上调出门店自己的提车点,判断依据从「同类型」改成「同属一个经营商户且类型可调拨」。这个修复已在 9 月 22 日晚上全量发布,发布后的验证结果尚未确认。
错误代码
// 车辆调拨:查询可调入的门店(脱敏教学示例)
class TransferDestinationQuery {
List<Shop> listDestinations(long sourceShopId) {
Shop source = shopMapper.selectById(sourceShopId);
List<Shop> result = new ArrayList<>();
// 为什么错:把「同一经营商户」写成了「和调出门店同类型」,
// 门店只有服务站一种时这条恒等于全部门店,新增服务中心后就排除了对方
result.addAll(shopMapper.selectByMerchantAndType(
source.getMerchantId(), source.getShopType()));
// 提车点挂在调出门店下,与门店类型无关,这一段本身没有问题
result.addAll(pickupPointMapper.selectByShopId(sourceShopId));
return result;
}
}
修复代码示例
// 修复后:可调入门店 = 同商户下的服务站 + 服务中心 + 调出门店下的提车点
class TransferDestinationQuery {
// 能承接车辆调拨的门店类型,服务站和服务中心都在其中
private static final List<ShopType> TRANSFER_SHOP_TYPES =
Arrays.asList(ShopType.SERVICE_STATION, ShopType.SERVICE_CENTER);
List<Shop> listDestinations(long sourceShopId) {
Shop source = shopMapper.selectById(sourceShopId);
// 修复点:不再用调出门店的类型过滤,改查该经营商户下所有可调拨类型
List<Shop> result = new ArrayList<>(shopMapper.selectByMerchantAndTypes(
source.getMerchantId(), TRANSFER_SHOP_TYPES));
// 提车点仍按调出门店查询,与改动无关
result.addAll(pickupPointMapper.selectByShopId(sourceShopId));
return result;
}
}
下次遇到这些场景要警惕
- 给门店、账号这类对象新增一种类型时:先把代码里所有按类型过滤的查询列出来(调拨候选、列表、报表、权限),逐条判断它要的是「只允许同类型」还是「同属一个上级」。然后用新类型和旧类型各建一条数据,双向各走一遍,确认该通的通、该拦的拦。
- 新类型复用旧类型实现时:把旧实现里每一处类型判断都标出来,问一句「只有一种类型时,这条判断是不是恒为真」。恒为真的判断,在新类型出现后就会变成一条限制。
- 需求文档只写新对象自身能力、没写它和既有流程的关系时:评审时补一张「新对象 × 既有入口」的表,把调拨、库存、结算、报表这些入口逐格写清改或不改;没有确认过的格子,不要默认「和旧类型一样」。
- 类型相关改动上线后的头两天:按类型组合造单——服务站调服务中心、服务中心调服务站、同类型互调、带提车点——每种都建一张,看候选列表是否完整、提交是否成功。