1. 问题现象与背景分析
最近在项目中使用MyBatis Plus的QueryWrapper进行条件查询时，发现一个容易被忽略但影响重大的问题：当使用ne（不等于）条件判断时，如果数据库字段值为NULL，这些记录会被错误地排除在查询结果之外。这个现象在业务逻辑中可能导致数据统计不准确、权限校验失效等严重问题。
举个例子，假设我们有一个用户表，其中status字段表示账号状态（1=正常，0=禁用，NULL=未激活）。当我们想查询所有非禁用账号时，很自然地会写出这样的代码：
java复制QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.ne("status", 0);
List<User> users = userMapper.selectList(wrapper);
预期结果是返回status=1和status=NULL的记录，但实际执行时却发现NULL值的记录被漏掉了。这是因为MyBatis Plus生成的SQL语句类似于：
sql复制SELECT * FROM user WHERE status != 0
而在SQL逻辑中，任何与NULL的比较操作（包括=、!=、>、<等）结果都是UNKNOWN，不会被包含在最终结果中。
2. 底层原理深度解析
2.1 SQL的三值逻辑体系
这个问题根源于SQL标准的三值逻辑（Three-valued logic）体系。与编程语言中常见的布尔逻辑（true/false）不同，SQL的判断结果可能有三种状态：
- TRUE：条件明确成立
- FALSE：条件明确不成立
- UNKNOWN：条件无法确定（通常因为涉及NULL值）
当使用!=或<>运算符时，如果比较的一方是NULL，结果就是UNKNOWN。在WHERE子句中，只有结果为TRUE的记录才会被返回，FALSE和UNKNOWN都会被过滤掉。
2.2 MyBatis Plus的Wrapper实现机制
MyBatis Plus的QueryWrapper最终会转换为SQL语句的WHERE条件部分。对于ne()方法，它的实现逻辑是简单的字段不等于值，没有特殊处理NULL值的情况。查看源码可以发现：
java复制public Children ne(R column, Object val) {
return this.doIt(true, column, SqlKeyword.NE, val);
}
这个方法直接使用了SQL的!=运算符，没有对NULL值做额外处理。这就是导致我们遇到问题的根本原因。
3. 解决方案与最佳实践
3.1 方案一：使用IS NULL明确包含NULL值
最直接的解决方案是额外添加IS NULL条件：
java复制QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.ne("status", 0).or().isNull("status");
生成的SQL将是：
sql复制SELECT * FROM user WHERE status != 0 OR status IS NULL
提示：这里必须使用
or()连接，如果使用and()会导致查询结果为空，因为一个字段不可能同时不等于0又是NULL。
3.2 方案二：使用Condition构造复杂条件
对于更复杂的场景，可以使用Condition来构建条件：
java复制QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.nested(w -> w.ne("status", 0).or().isNull("status"));
这种方式在需要组合多个条件时特别有用，可以保持代码的清晰性。
3.3 方案三：自定义Wrapper方法
如果项目中频繁遇到这种情况，可以封装一个自定义的Wrapper方法：
java复制public class MyQueryWrapper<T> extends QueryWrapper<T> {
public MyQueryWrapper<T> neWithNull(String column, Object val) {
return (MyQueryWrapper<T>) this.ne(column, val).or().isNull(column);
}
}
// 使用方式
MyQueryWrapper<User> wrapper = new MyQueryWrapper<>();
wrapper.neWithNull("status", 0);
4. 实际案例与性能考量
4.1 案例：用户权限过滤系统
假设我们有一个后台管理系统，需要筛选出"非管理员用户"进行特殊处理。管理员用户的role_id=1，其他用户可能是2、3等或NULL（未分配角色）。
错误写法：
java复制wrapper.ne("role_id", 1); // 会漏掉role_id为NULL的用户
正确写法：
java复制wrapper.ne("role_id", 1).or().isNull("role_id");
4.2 性能优化建议
-
索引利用：确保查询字段有适当的索引。对于上述例子，应该在status字段上建立索引。
-
NULL值比例：如果表中NULL值比例很高（超过30%），考虑使用COALESCE函数：
java复制wrapper.apply("COALESCE(status,-1) != 0");这里-1是一个不会出现在实际数据中的值。
-
避免全表扫描：复杂的OR条件可能导致索引失效，可以通过UNION ALL拆分查询：
java复制// 实际项目中可能需要使用UNION ALL的SQL写法 String sql = "(SELECT * FROM user WHERE status != 0) UNION ALL (SELECT * FROM user WHERE status IS NULL)";
5. 常见问题排查与调试技巧
5.1 问题现象速查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 查询结果比预期少 | 忽略了NULL值记录 | 添加IS NULL条件 |
| 条件组合结果异常 | AND/OR逻辑错误 | 检查nested()使用是否正确 |
| 索引未生效 | 复杂OR条件导致 | 考虑拆分查询或使用COALESCE |
5.2 调试技巧
-
打印实际SQL：
java复制
System.out.println(wrapper.getCustomSqlSegment()); -
使用MyBatis Plus的SQL分析插件：
java复制@Bean public PerformanceInterceptor performanceInterceptor() { PerformanceInterceptor interceptor = new PerformanceInterceptor(); interceptor.setFormat(true); return interceptor; } -
数据库兼容性：不同数据库对NULL的处理略有差异，特别是Oracle与MySQL之间。测试时应在目标数据库上验证。
6. 扩展思考与最佳实践
6.1 数据库设计建议
- 尽量避免允许字段为NULL，可以使用默认值代替（如0、-1等特殊值）
- 如果必须使用NULL，应在设计文档中明确其业务含义
- 为经常需要查询的NULL字段创建函数索引
6.2 MyBatis Plus使用规范
- 所有涉及不等条件的查询，都要考虑NULL值情况
- 复杂条件使用
nested()方法保持清晰 - 对于高频查询条件，封装成自定义方法
- 编写单元测试覆盖NULL值场景
6.3 替代方案比较
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 添加IS NULL | 简单直接 | 条件复杂时不易维护 | 简单查询 |
| 使用COALESCE | 单条件易优化 | 需要特殊默认值 | 高NULL比例表 |
| 自定义Wrapper | 复用性强 | 需要额外封装 | 项目通用 |
| 拆分查询 | 利于索引利用 | 代码量增加 | 大数据量表 |
在实际项目中，我通常会根据查询的复杂度和性能要求选择不同的方案。对于简单的CRUD操作，方案一足够使用；对于性能敏感的核心查询，可能需要采用更优化的方案四。