发生了什么
平台有两个入口:商户在门店用商户端替到店用户录入订单,叫“代客下单”;用户在自己的手机上打开用户端,能看到名下所有订单,并从列表进入后续的免押办理。代客下单只是由门店工作人员代替用户操作,订单本身仍然属于这位用户,理应出现在他的订单列表里。
订单记录上有一个“订单来源”字段,用来标明这笔订单从哪个渠道进入平台。用户端展示订单列表时,按当前用户查询名下订单。一次租赁业务融合改造后,产品要求聚合平台的订单不再出现在用户端列表,开发于是给这条列表查询追加了一个排除条件:来源不等于聚合平台的订单才返回。
调整后的查询对绝大多数订单都正常,但代客下单的订单查不出来了。这类订单写入时,订单来源字段没有赋值,存的是空值。空值不满足“不等于某个平台”的判断,整个查询条件对这几行不成立,它们被当作不符合条件的记录直接排除。用户打开列表看到的是“暂无订单”,也就无法继续办理免押。门店当天上午反馈用户找不到代客下单订单,研发定位后修改查询条件当天发布,列表恢复展示;此前产生的那批订单另按方案补上了来源默认值。
本质
问题不在“排除聚合平台”这个需求,而在这条排除条件的写法没有考虑字段可以为空。
- 订单来源字段允许空值。代客下单在写入时没有给这个字段赋值,数据库里存的是 NULL,不是空字符串,也不是“代客”这样的具体来源值。
- 开发把需求翻译成
ordering_source NOT IN ('聚合平台')。对来源有值的行,这个判断成立,这些订单正常返回。 - 对来源为空的行,SQL 的比较结果是“未知”,不是“真”。
WHERE只保留判断为真的行,于是这些代客订单既没有报错,也没有进入结果集,而是静默消失。
用一句话说:这条排除条件同时排掉了“聚合平台”和“没有填来源”两类订单,而后者并不是需求要排除的对象。
空值被误伤的地方很难在联调时暴露,因为查询不会抛异常,接口照常返回空列表,日志里也没有失败记录。验证时用一笔来源有值的订单走完整流程,页面看起来完全正常;只有拿一条来源为空的代客订单去查,才能看出它被漏掉。
修复方向是让条件显式承认空值:把它写成“来源为空,或来源不在要排除的集合里”,也就是在 NOT IN 前补上 IS NULL 分支;后续调整为正向写法,直接列出允许进入列表的来源,新增来源时再评审影响面。同时给已有的空来源代客订单补上默认来源值,避免其它按来源过滤的查询再踩同一处。当天改完查询条件已发布,用户端订单列表恢复展示。
错误代码
// 用户端订单列表查询(脱敏教学示例,示意字段与条件)
public List<OrderView> listUserOrders(long userId) {
String sql = "SELECT order_no, status, ordering_source "
+ "FROM order_info "
+ "WHERE user_id = ? "
// 为什么错:代客下单的 ordering_source 存的是 NULL,
// NULL NOT IN (...) 的结果是 UNKNOWN 而不是 TRUE,
// 整行被 WHERE 静默过滤,接口只会返回一个更短的列表
+ " AND ordering_source NOT IN ('AGG_PLATFORM')";
return jdbcTemplate.query(sql, ROW_MAPPER, userId);
}
修复代码示例
// 同一查询,只调整排除条件(脱敏教学示例)
public List<OrderView> listUserOrders(long userId) {
String sql = "SELECT order_no, status, ordering_source "
+ "FROM order_info "
+ "WHERE user_id = ? "
// 修复:先承认来源可能为空,空来源的行不再被排除条件吞掉
+ " AND (ordering_source IS NULL "
+ " OR ordering_source NOT IN ('AGG_PLATFORM'))";
List<OrderView> orders = jdbcTemplate.query(sql, ROW_MAPPER, userId);
// 也可以改成正向写法,显式列出允许展示的来源;
// 无论取哪种写法,都要先把空值或默认来源值纳入判断
return orders;
}
下次遇到这些场景要警惕
- 给列表查询追加排除条件:先对该字段做一次空值计数,确认有多少行没有值、这些行属于哪类业务,再决定放行还是排除。
- 在可空字段上使用
NOT IN:手写一条该字段为空的数据执行查询,看它是否仍出现在结果里;能改成正向枚举就改成正向枚举。 - 需求只写“排除某个平台”:把改动字段的取值分布逐个来源列出来对照,不要用“有值的订单查得到”代替这条验证。
- 改动订单列表这类入口查询:按来源各取一条订单构造回归数据,比对返回条数与来源分布,而不是只看页面能不能打开。