1. QueryWrapper 核心功能解析
QueryWrapper是MyBatis-Plus框架中用于构建SQL查询条件的核心工具类，它通过链式调用的方式让开发者能够以面向对象的形式编写数据库查询条件。我在实际项目中使用这个工具类已有三年多时间，它彻底改变了我们团队操作数据库的方式。
这个包装器的设计初衷是为了解决传统MyBatis中XML配置繁琐、动态SQL拼接复杂的问题。通过QueryWrapper，我们可以用Java代码直观地表达查询意图，比如等值查询、范围查询、模糊匹配等常见操作，而不用再手动拼接SQL字符串。
1.1 基础查询方法
最常用的几个基础方法包括：
eq()：等值查询，相当于SQL中的=ne()：不等查询，相当于SQL中的!=gt()：大于，相当于SQL中的>ge()：大于等于，相当于SQL中的>=lt()：小于，相当于SQL中的<le()：小于等于，相当于SQL中的<=
实际使用示例：
java复制QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("name", "张三")
.gt("age", 18)
.lt("age", 30);
注意：字段名建议使用常量定义而非直接写字符串，避免因字段名变更导致的错误。
1.2 复杂条件组合
QueryWrapper支持多种逻辑组合方式：
and()：AND连接多个条件or()：OR连接多个条件nested()：嵌套条件apply()：自定义SQL片段
复杂条件示例：
java复制wrapper.and(w -> w.eq("status", 1).or().eq("status", 2))
.nested(nw -> nw.gt("score", 90).lt("score", 100));
2. 高级查询技巧
2.1 模糊查询与特殊匹配
除了基础比较操作，QueryWrapper还提供了丰富的匹配方法：
like()：模糊匹配，相当于LIKE '%value%'likeLeft()：左模糊，相当于LIKE '%value'likeRight()：右模糊，相当于LIKE 'value%'notLike()：不包含匹配in()：IN查询notIn()：NOT IN查询between()：BETWEEN范围查询
模糊查询示例：
java复制wrapper.like("name", "张")
.notLike("address", "测试")
.in("id", Arrays.asList(1, 2, 3));
2.2 排序与分页
QueryWrapper可以方便地实现排序和分页：
orderByAsc()：升序排序orderByDesc()：降序排序last()：在SQL最后追加内容（常用于分页）
排序分页示例：
java复制wrapper.orderByDesc("create_time")
.last("LIMIT 10, 20");
提示：对于正式项目，建议使用MyBatis-Plus提供的Page对象进行分页，而非直接使用last方法。
3. 实际应用中的经验分享
3.1 性能优化建议
-
索引命中：确保QueryWrapper中的条件字段都有合适的索引。例如频繁使用
eq()的字段应该建立索引。 -
避免全表扫描：谨慎使用
like查询，特别是双模糊查询(like而非likeRight或likeLeft)，这类查询无法使用索引。 -
IN查询优化：当IN列表参数过多时（超过1000个），考虑分批查询或改用JOIN方式。
-
字段选择：使用
select()方法明确指定需要查询的字段，避免SELECT *。
优化示例：
java复制wrapper.select("id", "name", "age")
.eq("status", 1)
.likeRight("name", "张");
3.2 常见问题排查
-
SQL注入风险：虽然QueryWrapper本身有防注入机制，但使用
apply()或last()方法时仍需注意不要直接拼接用户输入。 -
空值处理：当参数可能为null时，使用条件方法的重载版本：
java复制wrapper.eq(Objects.nonNull(name), "name", name);
-
多表关联查询：复杂关联查询建议使用专门的DTO和JOIN查询，而非在QueryWrapper中硬编码关联逻辑。
-
日期比较：处理日期字段时，注意时区问题，建议统一使用UTC时间存储。
4. 扩展应用场景
4.1 动态查询构建
QueryWrapper特别适合构建动态查询条件。例如实现一个动态过滤功能：
java复制public QueryWrapper<User> buildUserQuery(String name, Integer minAge, Integer maxAge, Integer status) {
return new QueryWrapper<User>()
.like(StringUtils.isNotBlank(name), "name", name)
.ge(minAge != null, "age", minAge)
.le(maxAge != null, "age", maxAge)
.eq(status != null, "status", status);
}
4.2 Lambda表达式写法
MyBatis-Plus 3.x以后推荐使用LambdaQueryWrapper，可以获得更好的类型安全性和IDE支持：
java复制LambdaQueryWrapper<User> lambdaWrapper = new LambdaQueryWrapper<>();
lambdaWrapper.eq(User::getName, "张三")
.gt(User::getAge, 18);
Lambda写法的优势：
- 编译时类型检查
- IDE智能提示
- 重构友好
- 避免字段名拼写错误
5. 与其他技术的整合
5.1 与Spring Security整合
在权限控制场景下，可以结合Spring Security的权限信息动态构建查询条件：
java复制@Autowired
private SecurityContext securityContext;
public QueryWrapper<Document> buildDocumentQuery() {
QueryWrapper<Document> wrapper = new QueryWrapper<>();
wrapper.eq("status", 1);
if (!securityContext.isAdmin()) {
wrapper.eq("creator_id", securityContext.getCurrentUserId());
}
return wrapper;
}
5.2 与Redis缓存整合
对于高频查询，可以结合Redis缓存QueryWrapper的查询结果：
java复制public List<User> queryUsers(QueryWrapper<User> wrapper) {
String cacheKey = "user_query:" + wrapper.toString();
List<User> cached = redisTemplate.opsForValue().get(cacheKey);
if (cached != null) {
return cached;
}
List<User> result = userMapper.selectList(wrapper);
redisTemplate.opsForValue().set(cacheKey, result, 1, TimeUnit.HOURS);
return result;
}
注意：缓存QueryWrapper结果时要考虑数据实时性要求，合理设置过期时间。
在实际项目中，QueryWrapper已经成为我们处理数据库查询的首选工具。它不仅简化了代码，还提高了开发效率和可维护性。特别是在需要构建复杂动态查询的业务场景中，QueryWrapper的表现尤为出色。