LambdaQueryWrapper VS QueryWrapper：安全之选与灵活之刃

在MyBatis-Plus的日常开发中，不知道各位有没有点击到LambdaQueryWrapper或者QueryWrapper的源码中去看一看？尤其是发现前者方法有@SafeVarargs注解但是后者没有时，感觉挺奇怪的呢？
今天咱们就聊聊这两个的区别和实战选择。

---

一、核心差异：类型安全 vs 灵活字符串

想象一下在构建一个用户查询时：

// 传统QueryWrapper - 字符串字段名
QueryWrapper<User> qw = new QueryWrapper<>();
qw.eq("user_name", "张三")
  .gt("age", 18)
  .select("id", "user_name"); // 字段名全靠手写字符串

// LambdaQueryWrapper - 方法引用
LambdaQueryWrapper<User> lqw = new LambdaQueryWrapper<>();
lqw.eq(User::getUserName, "张三")
   .gt(User::getAge, 18)
   .select(User::getId, User::getUserName); // 编译期检查字段存在性

关键区别：

• QueryWrapper：通过字符串指定字段名。灵活但危险------字段名拼写错误？不存在的字段？而且即使你这里字段拼写错误了，idea浏览器它不可能给你提示的。
• LambdaQueryWrapper ：利用Java8的方法引用（比如上面的代码User::getUserName）。编译器实时校验字段是否存在，重构时IDE自动更新引用。

---

二、@SafeVarargs其实是Lambda的安全护盾

当你看到这样的链式调用：

lqw.and(lq -> lq.eq(User::getStatus, 1).or().gt(User::getScore, 90));

背后的and方法正是用了@SafeVarargs：

@SafeVarargs
public final Children and(Consumer<LambdaQueryWrapper<T>>... consumers) {
    // ...合并多个条件
}

为什么需要它？

1. 可变参数泛型问题 ：Java中泛型可变参数（如Consumer<T>...）可能导致堆污染警告
2. 安全承诺 ：@SafeVarargs告诉编译器："保证这些泛型参数类型是安全的"
3. 为什么不用QueryWrapper 它的条件方法参数通常是Object或具体类型（如eq(String column, Object val)），不涉及泛型可变参数，所以不需要此注解。

---

三、什么时候该用什么？

首选 LambdaQueryWrapper

1. 实体字段强关联查询 （如WHERE user_name='张三'）
2. 项目实体列频繁重构（当然了这个出现的情况可能比较少，一般字段定好不会改，除非特殊情况）

LambdaQueryWrapper<Order> lqw = new LambdaQueryWrapper<>();
//如何字段名写错？编译直接报错！现在编译器你写完Order::以后提示全部都出来了。
lqw.eq(Order::getUserId, 1001)
   .between(Order::getAmount, 100, 500); 

其次 QueryWrapper

1. 动态字段构建（字段名来自外部配置或用户输入）
2. 复杂SQL拼接 （如动态GROUP BY、自定义HAVING等等这些）
3. 跨表关联查询 （wrapper.eq("dept.pid", 666)）

public List<User> queryByField(String fieldName, Object value) {
    QueryWrapper<User> qw = new QueryWrapper<>();
    // Lambda无法实现这种动态性
    qw.eq(fieldName, value); 
    return userMapper.selectList(qw);
}

---

四、性能方面比较

常有人问："Lambda反射会影响性能吗？" 其实完全多虑：

1. LambdaQueryWrapper在启动时 解析方法引用生成SFunction元数据
2. 运行时直接缓存字段名，无反射开销
3. 与QueryWrapper性能差异比较的话几乎可以说是忽略不计

---

五、使用场景（各位自行选择）

场景特征	推荐选择	原因说明
固定实体字段查询	LambdaQueryWrapper	编译期安全，重构友好
动态字段/复杂SQL	QueryWrapper	字符串灵活拼接
多条件组合（and/or嵌套）	LambdaQueryWrapper	链式调用清晰，@SafeVarargs保障
关联查询（非实体直连字段）	QueryWrapper	Lambda默认不支持跨表字段引用

黄金法则 ：能用LambdaQueryWrapper的地方优先用它，因为编译器有错误提示，别因为字段的原因搞半天一看字段写错了；遇到动态需求再切回QueryWrapper，灵活应对复杂场景。

---