MyBatisPlus中QueryWrapper与@Select注解冲突解析

1. QueryWrapper的副作用与Select注解的冲突解析第一次在项目中同时使用MybatisPlus的QueryWrapper和Select注解时我遇到了一个令人困惑的问题明明wrapper已经设置了查询条件但最终执行的SQL却完全忽略了这些条件。经过排查发现这是因为Select注解会直接覆盖QueryWrapper的条件设置。具体来说当我们在Mapper接口中这样定义方法Select(select * from user where status 1) ListUser selectActiveUsers(Param(Constants.WRAPPER) QueryWrapperUser wrapper);然后这样调用QueryWrapperUser wrapper new QueryWrapper(); wrapper.eq(dept_id, 10); mapper.selectActiveUsers(wrapper);实际执行的SQL会是select * from user where status 1而不会包含dept_id10的条件。重要提示Select注解与QueryWrapper联用时注解中的SQL会完全覆盖wrapper条件。这是MybatisPlus的一个设计特性而非bug。解决方案有三种完全使用QueryWrapper移除Select注解在Select注解中使用${ew.customSqlSegment}引入wrapper条件改用XML映射文件方式我个人推荐第一种方案保持代码风格统一。如果必须使用注解第二种方案的正确写法应该是Select(select * from user where status 1 ${ew.customSqlSegment}) ListUser selectActiveUsers(Param(Constants.WRAPPER) QueryWrapperUser wrapper);2. LambdaQueryWrapper的类型安全之道在早期的MybatisPlus版本中我们不得不这样写条件查询QueryWrapperUser wrapper new QueryWrapper(); wrapper.eq(dept_id, 10) .like(user_name, 张);这种写法有两个明显问题字段名以字符串形式存在容易拼写错误重构时无法通过IDE自动更新字段名LambdaQueryWrapper的出现完美解决了这些问题。同样的查询可以这样写LambdaQueryWrapperUser wrapper new LambdaQueryWrapper(); wrapper.eq(User::getDeptId, 10) .like(User::getUserName, 张);实际开发中我总结了几个LambdaQueryWrapper的最佳实践对于高频查询条件可以封装成静态方法public static LambdaQueryWrapperUser activeUsers() { return new LambdaQueryWrapperUser() .eq(User::getStatus, 1); }复杂条件建议使用方法引用而非lambda表达式// 推荐 wrapper.eq(User::getDeptId, 10); // 不推荐 wrapper.eq(u - u.getDeptId(), 10);链式调用超过3个条件时建议换行提高可读性3. Service层的查询封装策略在Service层使用MybatisPlus时我观察到两种常见的查询模式3.1 基础查询模式public ListUser listUsersByDept(Long deptId) { return userService.lambdaQuery() .eq(User::getDeptId, deptId) .list(); }这种模式适合简单查询但存在重复代码问题。3.2 构建器模式我更喜欢使用构建器模式封装复杂查询public ListUser listUsers(UserQuery query) { return userService.lambdaQuery() .eq(query.getDeptId() ! null, User::getDeptId, query.getDeptId()) .like(StringUtils.isNotBlank(query.getKeyword()), User::getUserName, query.getKeyword()) .between(query.getStartTime() ! null query.getEndTime() ! null, User::getCreateTime, query.getStartTime(), query.getEndTime()) .list(); }这种写法的优势在于条件判断与查询逻辑分离支持动态条件拼接易于扩展新的查询条件对于分页查询我通常会这样封装public PageUser pageUsers(UserQuery query, Pageable pageable) { return userService.lambdaQuery() .eq(query.getDeptId() ! null, User::getDeptId, query.getDeptId()) .page(new Page(pageable.getPageNumber(), pageable.getPageSize())); }4. 性能优化与常见陷阱4.1 N1查询问题即使使用MybatisPlus也可能遇到经典的N1查询问题。例如ListOrder orders orderService.list(); orders.forEach(order - { User user userService.getById(order.getUserId()); order.setUser(user); });解决方案是使用MybatisPlus的selectMaps方法手动实现联表查询或者使用TableField注解配置关联关系。4.2 索引失效场景以下写法会导致索引失效wrapper.apply(DATE_FORMAT(create_time,%Y-%m-%d) 2023-01-01);应该改为wrapper.between(create_time, 2023-01-01 00:00:00, 2023-01-01 23:59:59);4.3 大数据量查询优化当需要导出大量数据时要避免一次性加载所有记录// 错误做法 ListUser allUsers userService.list(); // 正确做法 userService.lambdaQuery() .eq(User::getStatus, 1) .listWithOptimize(1000, users - { // 分批处理逻辑 });5. 日志与调试技巧5.1 SQL日志输出配置在application.yml中添加mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl或者在代码中设置PostConstruct public void setMybatisLog() { SqlSessionFactory sqlSessionFactory ...; sqlSessionFactory.getConfiguration().setLogImpl(StdOutImpl.class); }5.2 参数美化输出对于复杂的动态SQL建议使用以下工具类调试public static String getSql(LambdaQueryWrapper? wrapper) { return wrapper.getSqlSegment(); }5.3 性能监控集成p6spy监控真实SQL执行时间# application.properties spring.datasource.driver-class-namecom.p6spy.engine.spy.P6SpyDriver spring.datasource.urljdbc:p6spy:mysql://localhost:3306/test6. 扩展与自定义功能6.1 自定义SQL注入器如果需要扩展QueryWrapper功能可以实现自己的SQL注入器。例如添加notExists条件public class NotExists extends AbstractMethod { Override public MappedStatement injectMappedStatement(...) { String sql scriptSELECT * FROM %s WHERE NOT EXISTS (%s)/script; SqlSource sqlSource languageDriver.createSqlSource(...); return this.addSelectMappedStatement(...); } }6.2 逻辑删除优化默认的逻辑删除实现会在每个查询自动加上deleted0条件。如果需要临时忽略这个条件wrapper.ignoreLogicDelete()6.3 多租户支持配置多租户拦截器后所有查询会自动加上租户ID条件。特殊场景下需要忽略wrapper.ignoreTenant()7. 版本升级注意事项从MybatisPlus 3.x升级到4.x时有几个重大变更需要注意LambdaQueryWrapper的链式调用方式变化// 3.x wrapper.lambda().eq(User::getName, test); // 4.x wrapper.eq(User::getName, test);分页插件配置方式变化// 3.x Bean public PaginationInterceptor paginationInterceptor() {} // 4.x Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); return interceptor; }主键生成策略注解从TableId(type IdType.AUTO)变为TableId(type IdType.ASSIGN_ID)