发生了什么
换电业务里,用户把车上没电的电池取下来,换一颗满电的电池;网点就是摆放换电柜、提供换电服务的地点。电柜按型号区分,一台柜子又分成若干格口,每个格口放一颗电池,所以业务里常按“几格口柜”来称呼一台柜子。运营在后台修改网点信息时,走的是一份叫“补充协议”的单据:填好变更内容提交,系统在保存前做一次超标判断,按这个网点实际放的电柜,判断配置有没有超出规则允许的范围,通过了才保存。
正常时,运营打开补充协议,改完信息提交,系统按网点查出实际电柜,按规则判断通过,单据保存成功。
这次需求把超标判断的依据从“具体柜子型号”改成了“几格口柜”。为了兼容灰度开关切回旧逻辑的场景,产品在上线当天验收时又要求补一条校验:提交的电柜型号必须落在老逻辑的可选型号清单里。原因是灰度期间用户可能填了“6 格口柜”,开关切回旧逻辑后,如果不改信息直接提交,这个值在按型号配置的老规则里匹配不到。
这条校验被加在超标判断的公共入口上。补充协议本身不提交电柜型号,系统直接按网点查实际电柜,再拿实际型号走判断。实际设备里有型号不在配置清单中。开关处于关闭状态时,校验仍然对补充协议生效,这些设备被判成非法,提交被拦下。确认影响 2 个运营、6 个网点,共 14 次提交请求,其中包含重复提交;这些请求对应的补充协议都没有保存成功。
本质
- 原流程。补充协议不依赖表单里的电柜型号,它按网点编号查出实际电柜,再用这些电柜的信息做超标判断。型号不是用户这次填的,是设备档案里存的。
- 新增校验。判断依据换成格口数后,旧的“按型号匹配规则”还要兼容。产品担心灰度回退后用户提交的“6 格口柜”匹配不到老规则,于是要求:开关关闭时,提交的型号必须是老逻辑可选清单里的一个。
- 错在适用范围。这条校验成立的前提是“型号来自用户在下拉框里的选择”,所以可以用一份清单把输入管住。补充协议没有这个输入,走的是实际设备,设备型号的集合比配置清单大;清单外的型号是正常在用的设备,现在却被当成非法值。
- 为什么没被提前发现。校验是上线当天验收时追加的,研发直接把它放进了公共判断路径,测试和产品都没有提出重新评审技术方案,也没有人拿“不提交型号的入口”完整走一遍提交。
- 结果。运营点提交,系统查到清单外的实际型号,抛出校验错误,单据保存不了;重试还是同样的结果,所以 14 次请求里有重复。
把“约束用户输入”的可选值校验挂到公共判断入口上,系统自己查出来的实际数据也会被当成非法输入。
处置上,给配置补型号理论上能让当前设备通过,但每个城市的超标规则不同,要业务逐城逐型号补规则,工作量不可接受,所以没有采用。实际做法是重新发一版代码,去掉这条校验;开关关闭时不再判断老电柜类型,补充协议因此可以提交。修复后的验证结果,记录没有说明。
错误代码
// 补充协议提交前的超标判断(脱敏教学示例)
public void checkOverLimit(SupplementForm form) {
// 补充协议没有提交电柜信息,按网点查出实际电柜
List<Cabinet> cabinets = cabinetMapper.selectBySiteId(form.getSiteId());
for (Cabinet cabinet : cabinets) {
// 为什么错:model 来自设备档案,不是用户这次从下拉框选的值
String model = cabinet.getModel();
// 为什么错:却按“用户输入”去校验它是否命中老逻辑可选清单;
// 实际设备的型号集合比清单大,清单外的设备全被拦下
if (!config.isGridRuleEnabled()
&& !config.getOldSelectableModels().contains(model)) {
throw new BizException("电柜类型校验不通过,无法提交");
}
overLimitRule.check(cabinet, form);
}
}
修复代码示例
// 修复:补充协议不经过型号可选清单校验(脱敏教学示例)
public void checkOverLimit(SupplementForm form) {
List<Cabinet> cabinets = cabinetMapper.selectBySiteId(form.getSiteId());
for (Cabinet cabinet : cabinets) {
// 修复:按实际电柜的格口数继续判断,不再要求型号命中清单;
// 开关关闭时也不判断老电柜类型
overLimitRule.checkByGrid(cabinet.getGridCount(), form);
}
}
// 只有用户真的从下拉框选了型号的入口,才需要这条校验
public void validateChosenModel(String model) {
if (!config.isGridRuleEnabled()
&& !config.getOldSelectableModels().contains(model)) {
throw new BizException("电柜型号不在可选范围内");
}
}
下次遇到这些场景要警惕
- 往公共判断入口加校验时:先列出所有调用方,逐个确认传进来的是“用户填的值”还是“系统查出来的值”。面向输入的可选值校验只放在前者;后者要用实际数据分布验证,不能假设它落在清单内。
- 灰度开关带“切回旧逻辑”分支时:把开关的两种状态和各个入口列成矩阵,逐个走一遍提交。确认新增校验只在对应状态、对应入口执行,尤其检查它有没有落在多条业务共用的路径上。
- 用配置清单做硬拦截前:先统计线上实际数据的取值,看看清单外还有多少值、这些值是否合法。只要清单外存在正常业务数据,就不能把“不在清单内”直接判成错误。
- 修这类拦截问题时:不要默认“补配置”就是修复。先确认补配置的维护成本和大范围数据的分布;补配置只能让当前已知的型号通过,下一台没配过的设备还会再拦一次。