MyBatis-Plus核心功能与SpringBoot集成实战

1. MyBatis-Plus核心价值解析MyBatis-Plus作为MyBatis的增强工具包已经成为Java后端开发中的标配组件。我在多个企业级项目中深度使用该工具后发现它真正实现了只做增强不做改变的设计理念。最新3.5.x版本在SpringBoot 3.x环境下表现尤为出色通过自动注入基础CRUD方法开发者可以节省约60%的重复编码时间。这个工具最吸引我的特点是其无侵入性——即便在已有MyBatis项目中也能够平滑接入不会对现有代码产生任何破坏性影响。下面通过一个典型场景说明当我们需要开发用户管理模块时传统MyBatis需要手动编写UserMapper.xml和对应的Java接口而MyBatis-Plus只需让实体类继承BaseMapper就能立即获得18种常用数据操作方法。2. 环境搭建与基础配置2.1 SpringBoot集成方案当前主流项目通常采用SpringBoot 3.5.x与MyBatis-Plus的组合。以下是经过生产验证的Maven依赖配置dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.17/version /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-generator/artifactId version3.5.17/version scopecompile/scope /dependency关键提示避免同时引入mybatis和mybatis-plus的核心依赖这会导致类加载冲突。starter包已经包含所有必需组件。2.2 必要配置项详解在application.yml中需要配置的基本项包括mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # SQL日志输出 map-underscore-to-camel-case: true # 自动驼峰转换 global-config: db-config: id-type: auto # 主键自增策略 logic-delete-field: deleted # 逻辑删除字段 logic-not-delete-value: 0 logic-delete-value: 1这个配置实现了三个重要功能实时SQL日志输出开发阶段建议开启数据库下划线字段到Java驼峰属性的自动映射全局逻辑删除配置3. 核心功能实战指南3.1 实体类与Mapper设计基础实体类应该继承Model类以获得ActiveRecord模式支持Data TableName(sys_user) public class User extends ModelUser { TableId(type IdType.AUTO) private Long id; private String username; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableLogic private Integer deleted; }Mapper接口只需简单继承BaseMapper即可获得完整CRUD能力public interface UserMapper extends BaseMapperUser { // 自定义方法可以在这里声明 }踩坑记录TableField注解的fill属性配合MetaObjectHandler使用可以实现自动填充但在批量操作时需要注意手动触发填充逻辑。3.2 条件构造器高级用法QueryWrapper和LambdaQueryWrapper是构建查询条件的核心工具。以下是复杂查询示例// 多条件查询 LambdaQueryWrapperUser wrapper new LambdaQueryWrapper(); wrapper.select(User::getId, User::getUsername) .like(User::getUsername, admin) .between(User::getCreateTime, startDate, endDate) .orderByDesc(User::getId); // 嵌套SQL wrapper.nested(i - i.eq(User::getType, 1).or().eq(User::getType, 2));实际项目中我总结出几个优化点优先使用LambdaQueryWrapper避免硬编码字段名复杂条件建议拆分为多个wrapper最后用and/or连接select()指定字段能显著减少数据传输量3.3 分页查询最佳实践MyBatis-Plus的分页插件需要特别配置Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }服务层使用示例PageUser page new Page(1, 10); LambdaQueryWrapperUser wrapper ...; PageUser result userMapper.selectPage(page, wrapper); // 获取分页数据 ListUser records result.getRecords(); long total result.getTotal();性能提示当处理百万级数据分页时建议使用优化分页模式通过设置page.setOptimizeJoin(false)来避免不必要的count查询。4. 高级特性深度应用4.1 自动填充策略实现创建MetaObjectHandler实现类来处理自动填充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, getCurrentUsername()); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); this.strictUpdateFill(metaObject, updateBy, String.class, getCurrentUsername()); } }4.2 多租户方案实现通过TenantLineInnerInterceptor实现多租户数据隔离public class TenantInterceptor implements TenantLineHandler { Override public Expression getTenantId() { return new StringValue(getCurrentTenantId()); } Override public String getTenantIdColumn() { return tenant_id; } Override public boolean ignoreTable(String tableName) { // 忽略不需要租户隔离的表 return sys_config.equals(tableName); } }将此拦截器添加到MybatisPlusInterceptor中即可生效。5. 性能优化与问题排查5.1 SQL执行监控方案通过自定义拦截器实现慢SQL监控Intercepts({ Signature(type StatementHandler.class, method query, args {Statement.class, ResultHandler.class}), Signature(type StatementHandler.class, method update, args {Statement.class}) }) public class PerformanceInterceptor implements Interceptor { private static final long SLOW_SQL_THRESHOLD 1000; // 1秒 Override public Object intercept(Invocation invocation) throws Throwable { long start System.currentTimeMillis(); Object result invocation.proceed(); long duration System.currentTimeMillis() - start; if(duration SLOW_SQL_THRESHOLD) { StatementHandler handler (StatementHandler) invocation.getTarget(); String sql handler.getBoundSql().getSql(); log.warn(Slow SQL detected: {}ms - {}, duration, sql); } return result; } }5.2 常见问题解决方案问题1更新操作不触发自动填充原因使用updateById方法时未包含填充字段方案改用update(entity, wrapper)方法问题2逻辑删除失效检查点全局配置中的logic-delete-field名称是否与实体字段一致字段是否添加TableLogic注解数据库字段类型是否为Integer问题3分页total不正确解决方案page.setSearchCount(true); // 确保开启count查询 page.setOptimizeCountSql(false); // 禁用优化计数6. 代码生成器实战MyBatis-Plus Generator可以极速生成全套CRUD代码FastAutoGenerator.create(jdbc:mysql://localhost:3306/test, root, 123456) .globalConfig(builder - { builder.author(baomidou) .outputDir(System.getProperty(user.dir) /src/main/java); }) .packageConfig(builder - { builder.parent(com.example) .moduleName(system); }) .strategyConfig(builder - { builder.addInclude(sys_user, sys_role) .entityBuilder() .enableLombok() .controllerBuilder() .enableRestStyle(); }) .templateConfig(builder - { builder.disable(TemplateType.CONTROLLER); // 不生成Controller }) .execute();生成策略建议开发阶段使用全部生成生产环境禁用Controller生成复杂业务实体单独配置生成策略7. 插件扩展开发7.1 自定义拦截器案例实现数据权限过滤拦截器public class DataPermissionInterceptor implements InnerInterceptor { Override public void beforeQuery(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) { // 获取当前用户数据权限 SetLong deptIds getPermittedDeptIds(); // 修改SQL添加数据权限过滤 String newSql boundSql.getSql() AND dept_id IN ( StringUtils.join(deptIds, ,) ); resetSql(ms, boundSql, newSql); } }7.2 多数据源集成方案结合dynamic-datasource组件实现DS(slave) // 指定数据源 public ListUser selectFromSlave() { return userMapper.selectList(null); } Transactional DS(master) public void updateInMaster(User user) { userMapper.updateById(user); }事务提示跨数据源操作需要引入Seata等分布式事务解决方案本地事务注解Transactional在此场景下不生效。