资讯详情

深入了解 · 专业解读

SpringBoot整合MyBatis-Plus实战指南

发布时间：2026/7/21 5:14:28
SpringBoot整合MyBatis-Plus实战指南 1. SpringBoot整合MyBatis-Plus项目概述在Java企业级开发中SpringBoot和MyBatis-Plus的组合已经成为快速构建数据持久层的黄金搭档。SpringBoot提供了简洁的自动配置和快速启动能力而MyBatis-Plus作为MyBatis的增强工具在保留MyBatis所有特性的基础上进一步简化了开发流程。这套组合拳能让我们用最少的代码实现最常见的CRUD操作同时保持足够的灵活性应对复杂业务场景。我最近在重构一个老项目的持久层时完整走了一遍整合流程。相比原生MyBatisMyBatis-Plus的自动CRUD、条件构造器、分页插件等特性让开发效率提升了至少50%。特别是在处理多表关联查询时它的Wrapper条件构造器简直是个神器。不过在实际整合过程中依赖管理和配置环节还是有些坑需要注意这也是我写这篇完整指南的原因。2. 环境准备与依赖配置2.1 创建SpringBoot项目基础框架建议使用Spring Initializrstart.spring.io初始化项目选择以下核心依赖Spring Web如果涉及Web层Lombok简化实体类编写对应版本的JDBC驱动MySQL/H2等我习惯用IDEA的Spring Initializr插件创建项目这样可以直接在IDE中完成初始化。创建时注意SpringBoot版本选择2.x系列使用mybatis-plus-boot-starter3.x系列需要mybatis-plus-spring-boot3-starter3.5.13新增了boot4-starter重要提示SpringBoot 2.7.x是个长期支持版本生产环境推荐使用。最新3.x系列对Java基线版本要求较高需要Java17企业老项目迁移需谨慎。2.2 MyBatis-Plus核心依赖引入在pom.xml中添加对应starter以SpringBoot 2.7.x为例dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency配套依赖建议同步添加!-- 代码生成器非必须 -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-generator/artifactId version3.5.3.2/version /dependency !-- 分页插件建议添加 -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-extension/artifactId version3.5.3.2/version /dependency最近在帮团队解决依赖冲突时发现MyBatis-Plus 3.5.3版本对SpringBoot 2.7.x的兼容性最好。如果遇到类找不到的异常可以尝试以下排查步骤执行mvn dependency:tree查看依赖树重点关注mybatis、mybatis-spring的版本使用 排除冲突的传递依赖3. 完整配置流程详解3.1 数据源基础配置application.yml典型配置示例spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/mp_demo?useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 hikari: maximum-pool-size: 20 minimum-idle: 5对于分库分场景可以配置多数据源spring: datasource: master: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://master-host:3306/db username: root password: 123456 slave1: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://slave1-host:3306/db username: root password: 1234563.2 MyBatis-Plus专属配置在application.yml中添加MP特有配置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 mapper-locations: classpath*:/mapper/**/*.xml # XML文件位置几个实用配置项说明banner: false 可以关闭启动时的MyBatis-Plus图标sql-parser-cache: true 开启SQL解析缓存提升性能aggressive-lazy-loading: false 禁用激进懒加载3.3 主类与Mapper扫描配置启动类需要添加MapperScan注解SpringBootApplication MapperScan(com.example.mapper) // 替换为实际mapper包路径 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }如果项目结构复杂可以采用多包扫描MapperScan({com.module1.mapper, com.module2.mapper})4. 核心功能实现与验证4.1 实体类与Mapper接口编写实体类示例使用Lombok简化Data TableName(sys_user) // 指定表名 public class User { TableId(type IdType.AUTO) // 主键策略 private Long id; private String username; TableField(real_name) // 字段映射 private String realName; TableField(exist false) // 非表字段 private String tempField; }Mapper接口只需继承BaseMapper即可获得CRUD方法public interface UserMapper extends BaseMapperUser { // 自定义方法 Select(SELECT * FROM sys_user WHERE username #{name}) User selectByName(Param(name) String name); }4.2 服务层典型用法Service层示例Service public class UserServiceImpl extends ServiceImplUserMapper, User implements UserService { public PageUser pageQuery(int current, int size, String name) { QueryWrapperUser wrapper new QueryWrapper(); wrapper.like(StringUtils.isNotBlank(name), username, name); return page(new Page(current, size), wrapper); } }条件构造器的几个实用技巧lambda表达式写法更安全wrapper.lambda().eq(User::getUsername, name)嵌套条件使用nestedwrapper.nested(w - w.eq(status,1).or().eq(type,2))动态表名使用动态SQLwrapper.apply(date_format(create_time,%Y-%m){0}, month)4.3 分页插件配置与使用需要单独配置分页插件Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 分页插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); // 乐观锁插件 interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor()); return interceptor; } }分页查询示例PageUser page new Page(1, 10); // 当前页每页条数 QueryWrapperUser wrapper new QueryWrapper(); wrapper.orderByDesc(create_time); userMapper.selectPage(page, wrapper); ListUser records page.getRecords(); long total page.getTotal();5. 常见问题排查与优化5.1 典型异常解决方案Invalid bound statement异常检查MapperScan路径是否正确确认mapper.xml文件是否在resources/mapper目录下在pom.xml中添加资源过滤配置build resources resource directorysrc/main/resources/directory includes include**/*.xml/include /includes /resource /resources /build分页失效问题确保配置了分页插件检查Page对象参数是否正确传递在Controller层不要使用ResponseBody注解返回Page对象SQL注入警告使用LambdaQueryWrapper代替字符串字段名对于orderBy等动态字段使用SqlInjectionUtils检查5.2 性能优化建议批量操作使用executeBatchuserMapper.executeBatch(entities - { entities.forEach(entity - userMapper.insert(entity)); });复杂查询开启二级缓存mybatis-plus: configuration: cache-enabled: true大数据量导出使用流式查询userMapper.selectListByStream(wrapper, user - { // 处理每条数据 });5.3 生产环境最佳实践监控SQL执行Bean public PerformanceInterceptor performanceInterceptor() { PerformanceInterceptor interceptor new PerformanceInterceptor(); interceptor.setMaxTime(1000); // SQL执行最大时长(ms) interceptor.setFormat(true); // 格式化SQL return interceptor; }多租户实现方案public class TenantInterceptor implements InnerInterceptor { Override public void beforeQuery(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) { // 自动添加tenant_id条件 } }审计字段自动填充Bean public MetaObjectHandler metaObjectHandler() { return new MetaObjectHandler() { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); } }; }这套整合方案已经在我们的订单系统中稳定运行了8个月日均处理百万级数据量。最大的收获是简化了约70%的重复CRUD代码让团队能更专注于业务逻辑开发。特别是在处理动态条件查询时Wrapper构建器的链式调用比传统XML方式直观太多。不过要注意复杂联表查询还是需要自定义SQL这时候MyBatis-Plus的兼容性优势就体现出来了——你可以随时退回到原生MyBatis写法。

相关新闻