MyBatis-Plus lambdaQuery条件构造器：EQ、NE、GT等操作符实战解析

1. 为什么需要lambdaQuery条件构造器如果你用过MyBatis肯定遇到过这样的场景为了查询某个状态的数据不得不写一堆if判断来拼接SQL。比如查询用户列表要根据不同条件筛选代码里全是if(name!null){sqland name#{name}}这样的片段。不仅难看还容易出错。MyBatis-Plus的lambdaQuery就是为了解决这个问题而生的。它用Java8的Lambda表达式让我们可以用面向对象的方式写查询条件。比如查询创建时间大于今天的记录原来要写where create_time now()现在只需要.gt(TaskFlow::getCreateTime, DateUtil.now())代码瞬间清爽多了。我去年接手一个老项目里面有个查询方法有20多个if条件判断光是维护这些SQL拼接就让人头大。后来用lambdaQuery重构后代码量减少了60%而且再也不用担心SQL注入的问题了。2. 基础操作符详解2.1 EQ等于与NE不等于EQ是最常用的操作符相当于SQL中的。比如查询特定用户userService.lambdaQuery() .eq(User::getUsername, 张三) .list();这里有个实用技巧如果字段值是nullEQ会自动忽略这个条件相当于动态SQL。比如userService.lambdaQuery() .eq(username!null, User::getUsername, username) .list();NE就是!我经常用它来过滤掉某些状态的数据。比如查询非管理员用户userService.lambdaQuery() .ne(User::getRole, admin) .list();注意一个坑NE对null值的处理比较特殊。如果字段值是nullNE条件不会生效这点和EQ不同。2.2 GT大于、LT小于与范围查询GT和LT特别适合做数值或日期的比较。比如查询最近一周的订单orderService.lambdaQuery() .gt(Order::getCreateTime, DateUtil.lastWeek()) .lt(Order::getCreateTime, DateUtil.now()) .list();实际项目中我常用它们来做分页查询的时间范围限制。比如后台管理系统要查某段时间的操作日志logService.lambdaQuery() .gt(Log::getOperateTime, startDate) .lt(Log::getOperateTime, endDate) .orderByDesc(Log::getOperateTime) .page(page);这里有个性能优化点如果字段上有索引记得把范围查询条件放在最后这样可以利用索引的最左前缀原则。2.3 GE大于等于与LE小于等于GE和LE和GT/LT类似只是包含了等于的情况。比如查询本月完成的订单orderService.lambdaQuery() .ge(Order::getCompleteTime, DateUtil.beginOfMonth()) .le(Order::getCompleteTime, DateUtil.endOfMonth()) .list();在统计报表场景中我经常用它们来做闭区间查询。比如统计某个月的用户注册量userService.lambdaQuery() .ge(User::getRegisterTime, monthStart) .le(User::getRegisterTime, monthEnd) .count();3. 组合查询实战3.1 多条件组合lambdaQuery最强大的地方在于可以链式调用多个条件。比如查询某个价格区间内特定分类的商品productService.lambdaQuery() .eq(Product::getCategory, 电子产品) .gt(Product::getPrice, 1000) .lt(Product::getPrice, 5000) .list();我遇到过的一个真实案例电商后台需要查询待发货的VIP用户的订单。用lambdaQuery可以这样写orderService.lambdaQuery() .eq(Order::getStatus, 待发货) .eq(Order::getUserType, VIP) .ge(Order::getCreateTime, DateUtil.today()) .orderByAsc(Order::getCreateTime) .list();3.2 动态条件查询实际业务中查询条件往往是动态的。lambdaQuery可以很优雅地处理这种情况LambdaQueryWrapperUser query userService.lambdaQuery(); if(StringUtils.isNotBlank(username)){ query.eq(User::getUsername, username); } if(age ! null){ query.ge(User::getAge, age); } query.list();在Spring项目中我通常会把查询条件封装成DTO然后这样写public PageUser queryUsers(UserQueryDTO dto) { return userService.lambdaQuery() .eq(dto.getRole()!null, User::getRole, dto.getRole()) .like(dto.getName()!null, User::getName, dto.getName()) .ge(dto.getMinAge()!null, User::getAge, dto.getMinAge()) .le(dto.getMaxAge()!null, User::getAge, dto.getMaxAge()) .page(dto.toPage()); }4. 高级技巧与性能优化4.1 条件优先级控制有时候我们需要控制条件的优先级比如(A or B) and C。lambdaQuery可以用and和or方法实现userService.lambdaQuery() .and(q - q.eq(User::getRole, admin).or().eq(User::getRole, supervisor)) .eq(User::getStatus, active) .list();这个查询相当于where (roleadmin or rolesupervisor) and statusactive4.2 索引优化建议使用lambdaQuery时也要注意索引的使用最左前缀原则把等值查询条件放在前面范围查询放后面比如先eq再gt/lt避免对索引列使用函数比如.gt(User::getCreateTime, DateUtil.now())可以用索引但.gt(DateUtil.format(User::getCreateTime), 2023-01-01)就用不了索引4.3 与PageHelper的配合使用在分页查询时我推荐直接用MyBatis-Plus的Page对象PageUser page userService.lambdaQuery() .eq(User::getDepartment, 研发部) .ge(User::getEntryDate, startDate) .page(new Page(1, 10));这样既简单又高效PageHelper在某些场景下会有性能问题。5. 常见问题排查5.1 条件不生效怎么办我遇到过好几次lambdaQuery条件不生效的情况总结几个排查步骤检查字段名是否正确Lambda表达式编译后会转换成字段名如果数据库字段和实体类不一致要用TableField注解检查参数是否为nullEQ/NE对null参数的处理方式不同查看生成的SQL可以通过配置打印SQL来调试5.2 性能突然变慢如果发现某个查询突然变慢检查是否走了索引用explain分析执行计划避免全表扫描特别是大数据表一定要加合理的条件限制注意in查询的数量.in(User::getId, ids)如果ids太大性能会很差5.3 与XML映射文件共存有些复杂查询还是需要写XMLlambdaQuery可以和XML映射共存。我的经验是简单查询用lambdaQuery多表关联用XML动态SQL根据复杂度选择比如这个统计查询我就写在XML里select idcountUserByDepartment select department, count(*) from user where create_time #{startDate} group by department /select