1. 为什么选择MyBatis-Plus与Spring Boot组合在Java生态中持久层框架的选择直接影响着开发效率和系统性能。MyBatis作为老牌ORM框架虽然灵活但需要大量模板代码。而MyBatis-Plus在保留MyBatis所有特性的基础上通过内置通用Mapper和Service让单表操作几乎零SQL。Spring Boot与MyBatis-Plus的配合堪称黄金组合。Spring Boot的自动化配置特性使得MyBatis-Plus的集成变得异常简单。只需添加starter依赖配置数据源就能立即获得以下能力自动化的CRUD操作强大的条件构造器分页插件开箱即用乐观锁等企业级功能我经历过从原生MyBatis到MyBatis-Plus的迁移过程最大的感受是代码量减少了60%以上。特别是在快速迭代的业务场景中不再需要反复编写基础增删改查SQL让开发者能更专注于业务逻辑实现。2. 环境准备与项目初始化2.1 开发环境要求在开始整合前请确保你的开发环境满足以下要求JDK 1.8或更高版本推荐JDK 17Maven 3.5或Gradle 6.xIDEIntelliJ IDEA或EclipseSpring Boot 2.7.x或3.x版本注意MyBatis-Plus对不同Spring Boot版本有专门的starter选择时需特别注意版本匹配问题。2.2 创建Spring Boot项目通过Spring Initializr创建项目时建议选择以下依赖Spring Web可选根据项目需求Lombok强烈推荐减少样板代码H2 Database用于快速演示如果你使用IDEA可以直接通过以下步骤创建File → New → Project → Spring Initializr选择Java版本和Spring Boot版本添加上述依赖完成项目创建对于已有项目只需在pom.xml中添加相应依赖即可。3. MyBatis-Plus核心集成步骤3.1 依赖配置详解根据不同的Spring Boot版本需要选择对应的starter!-- Spring Boot 2.x -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- Spring Boot 3.x -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-spring-boot3-starter/artifactId version3.5.3.1/version /dependency为什么需要区分starter因为Spring Boot 3.x基于Jakarta EE 9包路径从javax变更为jakarta需要特殊适配。我在实际项目中曾因混用版本导致ClassNotFound异常这点需要特别注意。3.2 数据源配置在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连接池配置Spring Boot默认 hikari: maximum-pool-size: 20 minimum-idle: 5对于H2内存数据库的配置略有不同spring: datasource: driver-class-name: org.h2.Driver url: jdbc:h2:mem:testdb username: sa password: sql: init: mode: always schema-locations: classpath:schema.sql >SpringBootApplication MapperScan(com.example.mapper) public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }经验分享我习惯将Mapper接口放在mapper包下实体类放在entity包下这样结构更清晰。MapperScan的路径一定要准确否则会出现Invalid bound statement错误。4. 基础CRUD操作实战4.1 实体类设计使用Lombok简化实体类代码Data TableName(sys_user) // 指定表名 public class User { TableId(type IdType.AUTO) // 主键自增 private Long id; private String username; private Integer age; private String email; TableField(create_time) // 字段映射 private LocalDateTime createTime; }实体类设计的几个要点TableName用于指定表名当类名与表名不一致时使用TableId标记主键type属性指定主键策略TableField解决字段名不一致问题建议使用包装类型(Integer)而非基本类型(int)以便区分null值4.2 Mapper接口开发只需继承BaseMapper即可获得全套CRUD方法public interface UserMapper extends BaseMapperUser { // 无需任何方法已有基础CRUD }BaseMapper提供的主要方法包括insert(T entity) 插入记录deleteById(Serializable id) 按ID删除updateById(T entity) 按ID更新selectById(Serializable id) 按ID查询selectList(Wrapper queryWrapper) 条件查询4.3 Service层封装MyBatis-Plus还提供了IService接口进一步简化Service层开发public interface UserService extends IServiceUser { // 可扩展自定义方法 } Service public class UserServiceImpl extends ServiceImplUserMapper, User implements UserService { // 实现类只需继承ServiceImpl即可 }IService相比BaseMapper提供了更多批量操作方法如saveBatch(Collection entityList) 批量插入updateBatchById(Collection entityList) 批量更新listByIds(Collection? extends Serializable idList) 按ID集合查询5. 高级特性应用5.1 条件构造器使用QueryWrapper和LambdaQueryWrapper可以构建复杂的查询条件// 查询年龄大于18且邮箱不为空的用户 QueryWrapperUser wrapper new QueryWrapper(); wrapper.gt(age, 18) .isNotNull(email); ListUser users userMapper.selectList(wrapper); // Lambda方式推荐 LambdaQueryWrapperUser lambdaWrapper new LambdaQueryWrapper(); lambdaWrapper.gt(User::getAge, 18) .isNotNull(User::getEmail);条件构造器支持的操作包括eq/ne 等于/不等于gt/ge/lt/le 大于/大于等于/小于/小于等于like/notLike 模糊查询in/notIn 包含/不包含orderByAsc/orderByDesc 排序5.2 分页查询实现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); // 当前页每页大小 QueryWrapperUser wrapper new QueryWrapper(); wrapper.ge(age, 18); IPageUser userPage userMapper.selectPage(page, wrapper); System.out.println(总记录数 userPage.getTotal()); System.out.println(当前页记录 userPage.getRecords());5.3 自动填充功能实现MetaObjectHandler接口来处理自动填充字段Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } }然后在实体类中标记需要自动填充的字段TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.UPDATE) private LocalDateTime updateTime;6. 常见问题与解决方案6.1 映射问题排查当出现字段映射失败时检查以下几点数据库字段名与实体类属性名是否一致是否使用了TableField指定了正确的列名是否开启了驼峰命名转换默认开启可以在application.yml中添加配置打印SQL日志mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl6.2 事务管理Spring Boot中默认已集成事务管理只需在Service方法上添加TransactionalService public class UserServiceImpl extends ServiceImplUserMapper, User implements UserService { Transactional public void batchUpdate(ListUser users) { users.forEach(this::updateById); } }踩坑提醒确保使用的是org.springframework.transaction.annotation.Transactional注解而非javax或jakarta的。6.3 多数据源配置对于多数据源场景建议使用dynamic-datasource-spring-boot-starterdependency groupIdcom.baomidou/groupId artifactIddynamic-datasource-spring-boot-starter/artifactId version3.5.2/version /dependency配置示例spring: datasource: dynamic: primary: master datasource: master: url: jdbc:mysql://localhost:3306/master username: root password: 123456 slave: url: jdbc:mysql://localhost:3306/slave username: root password: 123456使用DS注解切换数据源Service DS(slave) // 默认使用slave数据源 public class UserServiceImpl implements UserService { DS(master) // 这个方法使用master数据源 public void addUser(User user) { // ... } }7. 性能优化建议7.1 SQL打印优化生产环境不建议使用StdOutImpl打印完整SQL可以改用SLF4Jmybatis-plus: configuration: log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl然后通过日志级别控制输出logging: level: com.example.mapper: debug7.2 批量操作优化MyBatis-Plus的saveBatch默认是逐条插入可以通过重写方法优化Transactional public boolean saveBatch(CollectionUser entityList) { return saveBatch(entityList, 1000); // 每批1000条 }或者使用executeBatchsqlSessionFactory.openSession(ExecutorType.BATCH).getMapper(UserMapper.class);7.3 缓存策略选择MyBatis-Plus支持二级缓存但生产环境建议对于读多写少的场景可以开启缓存对于频繁更新的数据建议禁用缓存考虑集成Redis作为集中式缓存禁用特定Mapper的缓存CacheNamespace(enabled false) public interface UserMapper extends BaseMapperUser { }8. 实际项目经验分享在电商项目中我们使用MyBatis-Plus处理了日均百万级的订单数据。以下是几点关键经验复杂查询处理对于多表关联查询仍然推荐使用XML方式编写SQL保持灵活性。MyBatis-Plus的Wrapper适合单表操作。字段加解密通过实现TypeHandler接口可以透明化处理敏感字段的加解密public class EncryptTypeHandler implements TypeHandlerString { // 实现加解密逻辑 } // 使用示例 TableField(typeHandler EncryptTypeHandler.class) private String mobile;多租户实现通过实现TenantLineInnerInterceptor可以轻松实现基于租户ID的数据隔离public class MyTenantLineHandler implements TenantLineHandler { Override public String getTenantIdColumn() { return tenant_id; } Override public Expression getTenantId() { return new StringValue(当前租户ID); } }审计日志集成结合MyBatis-Plus的DataChangeRecorderInnerInterceptor可以实现数据变更审计interceptor.addInnerInterceptor(new DataChangeRecorderInnerInterceptor());最后提醒虽然MyBatis-Plus大大简化了开发但过度依赖自动生成SQL可能导致性能问题。对于核心复杂业务仍然建议使用定制SQL。根据我的经验80%的简单CRUD使用MyBatis-Plus20%的复杂查询使用原生MyBatis这种组合效果最佳。