☰ 首页

最近使用

0
暂无使用记录,点击左侧工具开始使用

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, ...),代码更紧凑、意图更清晰。