1. MyBatis-Plus实战指南数据层高效开发之道作为Java生态中最受欢迎的ORM框架之一MyBatis-Plus在传统MyBatis基础上进行了全方位增强。我在三个大型企业级项目中深度使用后发现其BaseMapper与Wrapper组合能够减少约60%的数据层样板代码。本文将分享如何用这两大核心功能构建健壮的数据访问层。2. 环境准备与基础配置2.1 依赖引入与版本选择当前稳定版本3.5.3.x与Spring Boot 2.7.x/3.x的兼容性最佳。建议通过starter方式引入dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency注意Spring Boot 3.x用户需确认JDK版本≥17并检查lombok插件兼容性。常见报错you arent using a compiler supported by lombok通常由JDK版本不匹配引起。2.2 实体类注解精要TableName和TableField是必须掌握的基础注解TableName(value sys_user, autoResultMap true) public class User { TableId(type IdType.AUTO) private Long id; TableField(value username, condition SqlCondition.LIKE) private String name; TableField(exist false) private String tempField; }关键配置项说明autoResultMap自动生成resultMap用于复杂类型映射condition指定该字段在Wrapper中的默认匹配条件exist标记非表字段3. BaseMapper深度解析3.1 内置CRUD方法实战BaseMapper提供18个通用方法覆盖90%的单表操作场景。以用户管理为例public interface UserMapper extends BaseMapperUser {} // 注入使用 Autowired private UserMapper userMapper; // 批量插入实测比循环insert快5-8倍 ListUser users ...; userMapper.insertBatchSomeColumn(users); // 动态更新只更新非null字段 User updateUser new User(); updateUser.setId(1L); updateUser.setName(newName); userMapper.updateById(updateUser);3.2 高级特性应用3.2.1 逻辑删除最佳实践配置全局逻辑删除以delete_flag字段为例mybatis-plus: global-config: db-config: logic-delete-field: deleteFlag logic-not-delete-value: 0 logic-delete-value: 1此时调用deleteById()实际执行的是UPDATE语句。注意查询时会自动附加delete_flag0条件。3.2.2 乐观锁实现添加Version注解Version private Integer version;更新时MP会自动检测版本号User user userMapper.selectById(1L); user.setName(newName); userMapper.updateById(user); // 执行UPDATE...WHERE id1 AND version14. Wrapper动态条件构造4.1 QueryWrapper基础用法QueryWrapperUser wrapper new QueryWrapper(); wrapper.select(id, username) .like(username, 张) .between(age, 20, 30) .orderByDesc(create_time); ListUser users userMapper.selectList(wrapper);生成的SQLSELECT id,username FROM user WHERE username LIKE %张% AND age BETWEEN 20 AND 30 ORDER BY create_time DESC4.2 LambdaWrapper类型安全写法LambdaQueryWrapperUser wrapper Wrappers.lambdaQuery(); wrapper.select(User::getId, User::getUsername) .ge(User::getAge, 18) .nested(w - w.eq(User::getGender, 1).or().eq(User::getGender, 2));优势编译期字段检查IDE智能提示重构友好4.3 复杂查询构建技巧4.3.1 嵌套查询wrapper.inSql(dept_id, SELECT id FROM dept WHERE status 1);4.3.2 自定义SQL片段wrapper.apply(date_format(create_time,%Y-%m-%d) {0}, 2023-08-01);4.3.3 存在性检查优化wrapper.exists(SELECT 1 FROM user_role WHERE user_id user.id AND role_id 1);5. 分页查询实现方案5.1 基础分页配置Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }5.2 分页查询实践PageUser page new Page(1, 10); // 当前页, 每页条数 LambdaQueryWrapperUser wrapper ...; IPageUser userPage userMapper.selectPage(page, wrapper); System.out.println(总记录数 userPage.getTotal()); System.out.println(总页数 userPage.getPages());5.3 自定义分页SQLMapper接口定义Select(SELECT * FROM user ${ew.customSqlSegment}) IPageUser selectUserPage(PageUser page, Param(Constants.WRAPPER) WrapperUser wrapper);6. 性能优化与踩坑记录6.1 批量操作优化// 批量插入JDBC批处理 ListUser users ...; SqlSession sqlSession sqlSessionFactory.openSession(ExecutorType.BATCH); UserMapper mapper sqlSession.getMapper(UserMapper.class); users.forEach(mapper::insert); sqlSession.commit();6.2 查询结果映射陷阱当使用TableField(autoResultMap true)映射JSON字段时TableField(typeHandler FastjsonTypeHandler.class) private ListString tags;必须同时在Wrapper中指定resultMapwrapper.resultMap(baseResultMap);6.3 动态表名处理实现动态表名拦截器public class DynamicTableNameInterceptor implements InnerInterceptor { Override public void beforeQuery(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) { TableNameParser parser new TableNameParser(...); String newSql parser.parse(boundSql.getSql()); resetSql(ms, boundSql, newSql); } }7. 企业级应用实践7.1 多租户方案实现配置多租户拦截器public class TenantInterceptor implements InnerInterceptor { Override public void beforePrepare(StatementHandler sh, Connection conn, Integer transactionTimeout) { // 添加tenant_id条件 } }7.2 审计字段自动填充定义元对象处理器Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, createBy, String.class, getCurrentUser()); } }8. 常见问题排查指南问题现象可能原因解决方案更新操作不生效未设置Version或乐观锁版本冲突检查实体类版本字段确认数据库值Lambda查询报NPE使用::写法引用可能为null的字段改用字符串字段名或判空处理分页total错误配置了多个PaginationInnerInterceptor确保只添加一个分页拦截器逻辑删除失效全局配置与注解配置冲突统一使用一种配置方式我在金融项目中使用MyBatis-Plus处理日均百万级交易数据时发现两个关键性能优化点1) 复杂查询优先使用Select原生注解Wrapper组合2) 批量插入务必采用JDBC批处理模式。另外对于字段超过50个的宽表建议禁用自动映射手动指定TableField以提高解析效率。