发生了什么
线下业务里,网点是面向用户提供服务的门店,仓库是集中存放电池和设备的地方。这两类场所登记在后台系统里时都叫“站点”:每条站点记录除了名称、地址、所属城市,还带一个类型字段,标明这条记录是网点还是仓库。运营按城市查站点信息,靠这个类型区分自己正在看的是哪一类。
正常时,后台的仓库页面只查类型为仓库的站点,列出来的每一条都是仓库;网点页面也一样,只列网点。两个页面读的是同一批站点数据,但各自的范围由类型决定,边界很清楚,不应该互相串。
这次不一样的地方在仓库页面:不止一个城市的运营打开仓库信息,结果里出现了网点记录——它们是面向用户的服务门店,不是存货的仓库。运营清掉浏览器缓存、退出重新登录,页面依旧。处置是回滚这次发布。
本质
一句话:仓库和网点共用一个站点查询入口,查询时没有把“类型等于仓库”这个条件带上,返回的自然就不只是仓库。
- 站点数据里,网点和仓库是两类记录,靠类型字段区分。这个字段本身没有问题,问题在于查询时用没用到它。
- 两个页面的查询都走同一个查询入口:查网点和查仓库调用的是同一个查询接口,这个接口按城市、关键字等条件取数。
- 构造查询条件时,类型没有被加进去。接口返回的是该城市下所有类型的站点,而不是当前页面需要的那一类。
- 查询已经把网点记录一并返回,仓库页面按仓库的展示方式渲染,网点记录就照原样出现在页面上。
- 清缓存、重新登录没有用,是因为每次请求都会重新查一遍数据,拿到的还是同一个没有类型条件的查询结果。旧数据不在浏览器里,清本地缓存自然无效。
- 回滚把这次发布撤掉,查询回到发布前的行为;是否另有保留新逻辑的修复版本,尚未确认。
类型条件没有进查询,返回范围就从“仓库”扩大成了“该城市所有站点”。
下面两段 Java 代码是按上述机制写的最小教学示例,用于对比“类型缺失”和“类型必传”两种写法,不代表实际项目源码或已上线实现。
错误代码
// 站点查询入口(教学示意):网点和仓库两个页面共用
public class SiteQueryService {
private final SiteMapper siteMapper;
public List<SiteView> query(SiteQuery query) {
// 为什么错:只按城市和关键字过滤,条件里没有站点类型,
// 该城市下的网点和仓库记录会被一起查出来
List<Site> rows = siteMapper.selectByCity(
query.getCityCode(), query.getKeyword());
// 为什么错:结果不区分类型就按仓库返回,页面无从知道这条原本是网点
return rows.stream()
.map(row -> new SiteView(row.getCode(), row.getName()))
.collect(Collectors.toList());
}
}
修复代码示例
// 同一个查询入口:类型显式传入,并真正进入 SQL 的 where 条件
public class SiteQueryService {
private final SiteMapper siteMapper;
public List<SiteView> query(SiteQuery query, SiteType type) {
// 类型是必传条件,缺了直接拒绝,不再默认查“全部站点”
if (type == null) {
throw new IllegalArgumentException("site type is required");
}
// 为什么这样改:selectByCityAndType 的 SQL 必须带 site_type = #{type},
// 返回结果才只包含调用方要的那一类站点
List<Site> rows = siteMapper.selectByCityAndType(
query.getCityCode(), query.getKeyword(), type.name());
// 返回时带上记录自身的类型,页面可以据此校验,不再整批当作仓库
return rows.stream()
.map(row -> new SiteView(row.getCode(), row.getName(), row.getType()))
.collect(Collectors.toList());
}
}
下次遇到这些场景要警惕
- 一个查询入口同时服务两类对象时:把类型做成必传参数,并在 SQL 的 where 条件里核对;用同一个城市的网点、仓库各查一次,观察返回集合是否只含本类型。
- 复用已有查询接口接新页面时:先列出这个接口的所有调用方和各自应有的范围;每接一个页面就刷新看一次,检查页面是否出现另一类对象。
- 页面出现不属于本页面的记录时:先直接调接口看返回,确认是查询范围的问题还是前端渲染的问题;清缓存、换账号只能排除前端旧数据,不能当作修复。
- 回滚恢复之后:把“按类型查询”补成回归用例,选一个同时有网点和仓库的城市作为固定测试数据,避免下次改查询时又丢掉类型条件。