MyBatis-Plus 条件构造sql指南:常用条件与 and/or 逻辑嵌套
在 MyBatis-Plus 的日常开发中,条件构造器(Wrapper)是使用频率最高的组件之一。它能以链式调用的方式构建 WHERE 子句,配合 Lambda 方法引用还能在编译期校验字段合法性。但真正让开发者踩坑的,往往不是单个条件怎么写,而是多个条件之间的逻辑组合——尤其是 and 与 or 的嵌套优先级。本文从常用条件速查入手,重点拆解 and/or 的构造方式与避坑要点。
一、为什么优先使用 Lambda 构造器
MyBatis-Plus 提供了 QueryWrapper/UpdateWrapper(字符串字段名)和 LambdaQueryWrapper/LambdaUpdateWrapper(方法引用)两类构造器。生产环境建议优先使用 Lambda 系列:
// 推荐:方法引用,字段名写错编译期即报错
wrapper.eq(User::getName, "张三");
// 不推荐:字符串硬编码,字段名拼错只能在运行时暴露
wrapper.eq("name", "张三");
Lambda 构造器通过 User::getName 这类方法引用定位字段,彻底规避了字段名拼写错误和重构后字段不同步的问题。
二、常用条件速查
以下方法在 LambdaQueryWrapper 与 LambdaUpdateWrapper 中通用,是日常开发中覆盖 90% 以上场景的高频条件。
| 方法 | 对应 SQL | 用途说明 | Lambda 示例 |
|---|---|---|---|
eq
|
=
|
等于 |
.eq(User::getStatus, 1)
|
ne
|
<>
|
不等于 |
.ne(User::getType, "admin")
|
gt / ge
|
> / >=
|
大于 / 大于等于 |
.ge(User::getAge, 18)
|
lt / le
|
< / <=
|
小于 / 小于等于 |
.lt(User::getScore, 60)
|
between
|
BETWEEN
|
范围(含边界) |
.between(User::getTime, start, end)
|
like
|
LIKE '%值%'
|
全模糊匹配 |
.like(User::getName, "张")
|
likeLeft
|
LIKE '%值'
|
右模糊(后缀匹配) |
.likeLeft(User::getEmail, "@qq.com")
|
likeRight
|
LIKE '值%'
|
左模糊(前缀匹配) |
.likeRight(User::getPhone, "138")
|
in
|
IN (...)
|
集合匹配 |
.in(User::getId, idList)
|
isNull
|
IS NULL
|
为空判断 |
.isNull(User::getEmail)
|
isNotNull
|
IS NOT NULL
|
非空判断 |
.isNotNull(User::getPhone)
|
关于 likeLeft / likeRight 的记忆:likeRight 是通配符在右边(值%),匹配以指定值开头的记录;likeLeft 是通配符在左边(%值),匹配以指定值结尾的记录。数据量大时,前缀模糊(likeLeft)通常无法命中索引,需谨慎使用。
更新专属方法
LambdaUpdateWrapper 还提供了直接指定更新字段的能力,无需依赖实体对象:
| 方法 | 用途 | 示例 |
|---|---|---|
set
|
指定更新字段与值 |
.set(User::getName, "新名字")
|
setIncrBy
|
数值字段自增(3.5.6+) |
.setIncrBy(User::getCount, 1)
|
setDecrBy
|
数值字段自减(3.5.6+) |
.setDecrBy(User::getBalance, 100)
|
所有条件方法均支持 boolean condition 作为第一个参数的重载形式,用于动态控制条件是否生效:
String name = param.getName();
Integer minAge = param.getMinAge();
wrapper.eq(name != null, User::getName, name) // 仅当 name 非空时生效
.ge(minAge != null, User::getAge, minAge); // 仅当 minAge 非空时生效
三、and 与 or 的构造
and 与 or 的核心作用是控制条件之间的逻辑连接与嵌套优先级。默认情况下,连续调用的条件自动用 AND 连接;而直接使用无参数的 .or() 会改变后续条件的连接方式,这在复杂查询中极易产生非预期的 SQL。
1. 默认 AND 与简单 OR
// WHERE name = ? AND age = ?
wrapper.eq(User::getName, "张三").eq(User::getAge, 20);
// WHERE name = ? OR age = ?
wrapper.eq(User::getName, "张三").or().eq(User::getAge, 20);
简单 OR 仅适用于平级的 A OR B 场景。一旦涉及 A AND (B OR C) 或 (A AND B) OR C,直接链式 .or() 容易导致逻辑错乱,因为它会改变整个后续链路的连接符。
2. 嵌套构造(推荐用法)
为精确控制括号层级和逻辑优先级,应使用带 Consumer 参数的 and() 或 or() 方法,在括号内构建独立的逻辑块。
场景一:A OR (B AND C)
需求:查询名字为"张三"或者(年龄大于 18 且邮箱不为空)的用户。
wrapper.eq(User::getName, "张三")
.or(w -> w.gt(User::getAge, 18).isNotNull(User::getEmail));
// SQL: WHERE name = ? OR (age > ? AND email IS NOT NULL)
场景二:(A AND B) OR (C AND D)
需求:(状态为 1 且类型为 A)或者(状态为 2 且类型为 B)。
wrapper.and(w1 -> w1.eq(User::getStatus, 1).eq(User::getType, "A"))
.or(w2 -> w2.eq(User::getStatus, 2).eq(User::getType, "B"));
关键在于每个逻辑块都通过带参数的 and/or 显式包裹,避免裸 .or() 污染外层连接关系。
场景三:复杂嵌套 A OR (B AND (C OR D))
需求:名字不为"张三"或者(名字为"张三"且(年龄为空或年龄大于 11))。
wrapper.ne(User::getName, "张三")
.or(w -> w.eq(User::getName, "张三")
.and(w2 -> w2.isNull(User::getAge).or().ge(User::getAge, 11)));
这种写法能生成清晰的嵌套结构,避免直接 .or() 在深层逻辑中破坏外层条件的优先级。
3. nested 方法
当你需要创建一个不默认携带 AND 或 OR 连接符的独立条件块时,可以使用 nested(Consumer)。它主要用于在已处于某个逻辑块内部时,再开启一个新的括号层级,由外层逻辑决定它如何连接。日常开发中,大多数嵌套需求通过 and(Consumer) 和 or(Consumer) 已足够覆盖,nested 适合需要精细控制括号起始逻辑的少数场景。
四、避坑提醒
-
不要滥用无参
.or():在循环或复杂判断中,直接.or()极易导致WHERE a AND b OR c AND d这种优先级错误的 SQL。凡是需要"分组"的语义,一律用带Consumer的and/or。 -
Wrapper 非线程安全:不要将 Wrapper 作为类的成员变量复用,每次数据库操作前
new一个新实例。 -
善用 SQL 日志:开发阶段开启 MyBatis-Plus 的 SQL 打印,确认生成的
WHERE子句括号位置是否符合预期,这是排查and/or问题最直接的方式。 -
动态条件用 condition 重载:与其手写
if (xx != null) wrapper.eq(...),不如直接用.eq(xx != null, ...),代码更紧凑、意图更清晰。
- 上一篇:一次查询结果不一致来讲MySQL 中NULL与空字符串的区别
- 下一篇:无