Mybatis-Plus中QueryWrapper 与 LambdaQueryWrapper 的区别-平芜编程栈

QueryWrapper 与 LambdaQueryWrapper 的区别

1.基本区别

QueryWrapper

java

// 使用字符串表示字段名 QueryWrapper<User> queryWrapper = new QueryWrapper<>(); queryWrapper.eq("name", "张三") .gt("age", 18) .like("email", "@qq.com");

LambdaQueryWrapper

java

// 使用Lambda表达式引用字段 LambdaQueryWrapper<User> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.eq(User::getName, "张三") .gt(User::getAge, 18) .like(User::getEmail, "@qq.com");

2.核心区别对比

特性	QueryWrapper	LambdaQueryWrapper
字段引用方式	字符串硬编码	Lambda表达式
类型安全性	编译期不检查字段是否存在	编译期检查，类型安全
重构友好性	重命名字段需手动修改字符串	IDE自动重构
代码可读性	一般	更好，直接关联实体类
性能	相同	相同
防SQL注入	都防SQL注入	都防SQL注入

3.详细对比

3.1 类型安全性

java

// QueryWrapper - 编译期不报错，运行时报错 queryWrapper.eq("nam", "张三"); // 拼写错误，编译时不检查 // LambdaQueryWrapper - 编译期报错 lambdaWrapper.eq(User::getNam, "张三"); // 编译时报错：找不到getNam方法

3.2 重构友好性

java

// QueryWrapper - 重命名需要手动修改 // 假设把字段 name 改为 username queryWrapper.eq("name", "张三"); // ❌ 需要手动改为 "username" // LambdaQueryWrapper - IDE自动重构 lambdaWrapper.eq(User::getName, "张三"); // ✅ 重命名实体类字段时自动更新

3.3 复杂查询对比

java

// QueryWrapper QueryWrapper<CapitalInfo> queryWrapper = new QueryWrapper<>(); if (StringUtils.isNotBlank(capitalName)) { queryWrapper.like("capital_name", capitalName); } if (capitalYear != null) { queryWrapper.eq("capital_year", capitalYear); } // LambdaQueryWrapper LambdaQueryWrapper<CapitalInfo> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.like(StringUtils.isNotBlank(capitalName), CapitalInfo::getCapitalName, capitalName) .eq(capitalYear != null, CapitalInfo::getCapitalYear, capitalYear);

4.实际使用示例

QueryWrapper 使用场景

java

// 1. 动态字段名（字段名是变量） String fieldName = getFieldNameFromRequest(); // 可能是 "name" 或 "username" QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq(fieldName, "张三"); // Lambda方式无法实现 // 2. 复杂动态SQL拼接 QueryWrapper<User> wrapper = new QueryWrapper<>(); if (condition1) { wrapper.eq("field1", value1); } else { wrapper.isNull("field1"); } if (condition2) { wrapper.in("field2", Arrays.asList(1, 2, 3)); } // 3. 表连接查询 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("u.status", 1) .eq("r.role_type", "admin") .apply("u.role_id = r.id");

LambdaQueryWrapper 使用场景

java

// 1. 常规查询（推荐） LambdaQueryWrapper<CapitalInfo> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(CapitalInfo::getCapitalState, 1) .like(CapitalInfo::getCapitalName, "测试") .orderByDesc(CapitalInfo::getCreateTime); // 2. 链式调用 List<CapitalInfo> list = capitalInfoMapper.selectList( new LambdaQueryWrapper<CapitalInfo>() .eq(CapitalInfo::getCapitalYear, 2024) .in(CapitalInfo::getCapitalType, Arrays.asList("A", "B", "C")) .groupBy(CapitalInfo::getCapitalSource) ); // 3. 条件判断简化 LambdaQueryWrapper<CapitalInfo> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(queryDTO.getCapitalState() != null, CapitalInfo::getCapitalState, queryDTO.getCapitalState()) .like(StringUtils.isNotBlank(queryDTO.getCapitalName()), CapitalInfo::getCapitalName, queryDTO.getCapitalName());

5.性能比较

两者在性能上没有区别，最终都会转换为相同的SQL语句：

sql

-- 两者生成的SQL相同 SELECT * FROM capital_info WHERE capital_state = 1 AND capital_name LIKE '%测试%' ORDER BY create_time DESC

6.最佳实践建议

7.混合使用示例

java

// 可以使用QueryWrapper的lambda()方法 QueryWrapper<CapitalInfo> wrapper = new QueryWrapper<>(); wrapper.lambda() // 转换为Lambda方式 .eq(CapitalInfo::getCapitalState, 1) .like(CapitalInfo::getCapitalName, "测试"); // 或者反过来 LambdaQueryWrapper<CapitalInfo> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.eq(CapitalInfo::getCapitalState, 1); QueryWrapper<CapitalInfo> queryWrapper = lambdaWrapper.getWrapper(); // 可以继续添加字符串方式的查询条件 queryWrapper.apply("DATE(create_time) = CURDATE()");

8.结论

方面	推荐	原因
新项目开发	LambdaQueryWrapper	类型安全，重构友好
字段名固定	LambdaQueryWrapper	减少硬编码错误
字段名动态	QueryWrapper	灵活性强
代码可读性	LambdaQueryWrapper	直观明了
兼容性	QueryWrapper	所有场景都适用