发生了什么
平台上的商户分两级:一级商户负责拓展合作,二级商户挂在一级商户名下。平台为渠道柜准备了一份专用配置,这份配置维护在一级商户这一层,再下放到二级商户页面:页面按一级商户逐条列出,每条带上该一级商户名下已经关联的二级商户,配置就在这份列表里查看和修改。
正常情况应该是:库里有多少一级商户,页面就列出多少条。名下有二级商户的,把二级商户一并带出来;名下暂时还没有关联二级商户的,也应该以一条子列表为空的记录出现,配置照样能看到、能改。
这次上线后,一部分一级商户在页面的查询结果里整条消失了。不是二级商户没带出来,而是连一级商户那一行都没有。使用者按商户去查配置,页面上找不到这个商户,既确认不了它当前的配置,也改不了。
排查后确认问题出在查询结果的组装上:程序遍历一级商户,先为每个一级商户装配名下的二级商户列表,再把一级商户放进返回结果;而“放进返回结果”这一步被写成了“二级商户列表不为空才执行”。名下没有二级商户的一级商户,列表本来就是空的,于是整条记录被跳过。数据没有被删,也不是权限问题,库里记录都在,只是没有进入返回结果。
影响数量记录没有统计。处理上有一个两难:回滚到上一个版本,之前已经单独把二级商户开关打开的商户会反过来变成数据不可见;不回滚,则会有更多业务人员陆续反馈同样的问题。记录里提到的兜底办法是给这些一级商户补一条二级商户配置,让它重新有内容可展示,研发倾向紧急修复、紧急上线。记录没有说明最终选了哪种方式,也没有说明修复是否上线验证。
本质
列表页要的是一棵两层的树:父节点是一级商户,子节点是它名下的二级商户。程序分三步装配这棵树:
- 查出全部一级商户,作为候选父节点。
- 逐个查这个一级商户名下的二级商户,把结果挂到父节点上。
- 把准备好的父节点放进返回列表。
第三步本应是无条件的,因为“这个一级商户存在”在第二步之前就已经确定。但代码把第三步放进了“子列表非空”这个条件里面,空子列表的父节点在装配阶段就被丢掉,接口返回的结果里根本没有它,页面也就渲染不出来。
父记录要不要返回,和它有没有子记录是两件事;空列表是一个正常结果,不是“这条记录不存在”。
这类遗漏难在测试时发现,是因为它不报错、不抛异常,接口照常返回成功,只是结果少了几条。用一笔“名下有二级商户”的数据去验,页面看起来完全正常;只有专门造一个“名下没有任何二级商户”的一级商户,才会看到它不见了。测试侧的复盘也指向同一处:写用例的人对商户业务熟悉,但仍漏了这个场景;执行的人是临时接手,主要按交接的用例走,没有做探索性测试;这个查询所在的服务当时也统计不到覆盖率,没有指标能提示这块没被覆盖。
修复方向是把两件事拆开:先为每个一级商户建立条目并放进结果集,子列表先给空集合;查到二级商户后再填进去,查不到就保留空集合。同时补一条针对性回归数据——一个没有任何二级商户关联的一级商户,确认它仍然出现在结果里、子列表为空。如果业务上确实只想展示“有二级商户的”一级商户,那也应该由查询条件显式表达,并在页面上说明,而不是在装配循环里静默跳过。记录没有给出具体修复代码,以上是修复方向。
错误代码
// 脱敏教学示例:按一级商户装配两级结构,返回给配置查询页
public List<MerchantNode> queryConfigPage() {
List<Merchant> firstLevel = merchantMapper.listByLevel(1);
List<MerchantNode> result = new ArrayList<>();
for (Merchant first : firstLevel) {
List<Merchant> seconds = merchantMapper.listByParentId(first.getId());
MerchantNode node = new MerchantNode(first);
node.setChildren(seconds);
// 为什么错:把“有没有子商户可展示”当成了“要不要返回这个父商户”,
// 名下还没有关联二级商户的一级商户被整条跳过,页面上查不到它
if (seconds == null || seconds.isEmpty()) {
continue;
}
result.add(node);
}
return result;
}
修复代码示例
// 修复:父商户先入结果集,二级商户列表允许为空
public List<MerchantNode> queryConfigPage() {
List<Merchant> firstLevel = merchantMapper.listByLevel(1);
List<MerchantNode> result = new ArrayList<>();
for (Merchant first : firstLevel) {
MerchantNode node = new MerchantNode(first);
// 先入结果集:父记录是否存在,与它有没有子记录无关
result.add(node);
List<Merchant> seconds = merchantMapper.listByParentId(first.getId());
// 查不到二级商户时保留空集合,页面仍能看到并维护这个一级商户的配置
node.setChildren(seconds == null ? Collections.emptyList() : seconds);
}
return result;
}
下次遇到这些场景要警惕
- 给树形或分组列表补“是否展示无子项父节点”之类判断时,先造一个没有任何子记录的最高层对象调一次接口,确认它仍在返回结果里,且子列表是空数组而不是整条缺失。
- 装配查询结果时,把“父对象进结果集”和“子对象填充”写成两步,父对象入结果的位置不要被任何子列表条件包住;代码评审专门看这一处。
- 需求临时交接时,先列出这个查询要覆盖的分支(有子项、无子项、子项被过滤掉、父项本身停用),逐条准备数据,不要只用交接用例里的正常数据。
- 决定回滚前先比对版本差异:新版本新增了哪些配置项或开关,旧版本读不到这些数据会表现成什么;回滚不一定等于恢复原状。