wrapper链式调用失效因方法返回新实例而非原对象,属不可变设计;正确写法需链式调用或赋值,避免引用丢失。

Wrapper 链式调用为什么拼着拼着就失效了
因为 Wrapper 的大多数方法(如 eq()、like()、in())返回的是新实例,不是原对象——它内部是不可变设计。你以为在“往同一个对象上加条件”,其实每次都在生成新对象,旧引用早就断了。
- 错误写法:
QueryWrapper<user> w = new QueryWrapper(); w.eq("age", 18); userMapper.selectList(w);</user>→ 这里eq()返回了新QueryWrapper,但你没接住,w还是空的 - 正确写法:必须链式或赋值,比如
userMapper.selectList(new QueryWrapper<user>().eq("age", 18).like("name", "张"))</user> - 如果中间要分支判断,别用临时变量覆盖原引用,改用
apply()或提前构造好再传入,或者用LambdaQueryWrapper配合if块内直接调用
LambdaQueryWrapper 比 QueryWrapper 少踩一半坑
QueryWrapper 用字符串写字段名,编译不检查,重构时字段一改就报 org.apache.ibatis.reflection.ReflectionException;LambdaQueryWrapper 用方法引用来指定字段,IDE 能跳转、能重命名、编译期报错。
- 安全写法:
new LambdaQueryWrapper<user>().eq(User::getAge, 25).like(User::getName, "李")</user> - 注意:不能对 null 字段引用,比如
User::getDeleted如果是布尔包装类且可能为 null,eq()会抛 NPE;建议先判空,或用isNull()/isNotNull() - 不支持动态表名或字段名——Lambda 形式锁死了实体类结构,想运行时拼字段?只能退回
QueryWrapper+ 字符串,但得自己兜底校验
多个 or 条件嵌套时,and 和 or 的优先级怎么控制
MyBatis-Plus 的 or() 默认是和上一级同级的 or,不是括号内的 or。想表达 (a=1 AND (b=2 OR c=3)),必须显式用 and() + or() 函数式写法包裹。
- 错误理解:
w.eq("a", 1).and(i -> i.eq("b", 2).or().eq("c", 3))→ 这个or()是和eq("b", 2)并列,实际生成a=1 AND (b=2 OR c=3),是对的 - 但写成
w.eq("a", 1).eq("b", 2).or().eq("c", 3)就变成(a=1 AND b=2) OR c=3,容易误读 - 真正需要多层括号时,用
and()接一个Consumer<children></children>,里面再嵌or(),例如:and(q -> q.eq("x", 1).or(r -> r.like("y", "a").like("z", "b")))
Wrapper 传参为空时怎么避免查出全表
用户没输任何搜索条件,你却执行了 select * from user where 1=1 —— 这是 QueryWrapper 默认行为,也是线上慢查询常见源头。
- 最简单防御:在 service 层加空校验,
if (wrapper.getExpression() == null) { throw new IllegalArgumentException("查询条件不能为空"); } - 更稳妥做法:用
EmptyWrapper替代默认空 Wrapper,或者初始化时就设last("LIMIT 0"),等条件补全再用clear()清掉 - 注意
lambdaQuery().eq(null, null)不会报错,但会生成WHERE column IS NULL,如果字段不允许 null,这条件永远不命中——看着像没查,实则全表扫描后无结果
Wrapper 的链式调用看着流畅,但每个点都是引用切换;字段写错、空值处理、括号层级、空条件放行——四点里漏一个,查出来的数据就不是你要的。










