1. MyBatisPlus与SpringBoot整合概述

MyBatisPlus作为MyBatis的增强工具包，在保留MyBatis所有特性的基础上，提供了更多便捷功能。与SpringBoot结合使用时，能显著减少传统MyBatis的模板代码量。2022年发布的3.3.1版本在性能优化和功能扩展方面都有明显提升，特别是对SpringBoot 2.5.x系列的兼容性支持更为完善。

实际开发中，这种组合能解决几个典型痛点：

• 自动生成CRUD操作代码，减少重复劳动
• 内置分页插件避免手动实现分页逻辑
• 提供Lambda表达式写法增强代码可读性
• 支持ActiveRecord模式简化数据库操作

2. 环境准备与项目初始化

2.1 开发环境配置

推荐使用以下环境组合：

• IDE：IntelliJ IDEA 2022.2+（对SpringBoot支持最完善）
• 构建工具：Maven 3.8.6（注意配置阿里云镜像加速依赖下载）
• JDK：1.8.0_351（建议使用Oracle JDK或OpenJDK）
• 数据库：MySQL 8.0.31（注意时区参数配置）

重要提示：MySQL 8.x必须添加rewriteBatchedStatements=true参数才能启用批量操作优化

2.2 项目创建关键步骤

1. 通过Spring Initializr创建项目时勾选：

   • Spring Web（用于REST接口）
   • Lombok（简化实体类代码）
   • MySQL Driver（数据库连接）

2. 手动添加MyBatisPlus依赖：

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.3.1</version> </dependency>

3. 配置文件建议使用YAML格式：

mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启SQL日志 global-config: db-config: logic-delete-field: deleted # 逻辑删除字段名 logic-not-delete-value: 0 logic-delete-value: 1

3. 核心功能实现详解

3.1 实体类设计规范

实体类需要遵循特定注解规范：

@Data @TableName("sys_user") // 表名映射 public class User { @TableId(type = IdType.AUTO) // 主键策略 private Long id; @TableField("user_name") // 字段映射 private String username; @TableField(exist = false) // 非表字段 private String tempData; }

3.2 Mapper层最佳实践

基础Mapper接口应继承BaseMapper：

@Mapper public interface UserMapper extends BaseMapper<User> { // 自定义SQL示例 @Select("SELECT * FROM user WHERE age > #{age}") List<User> selectByAge(@Param("age") Integer age); }

3.3 Service层封装技巧

推荐使用MyBatisPlus提供的IService接口：

public interface UserService extends IService<User> { // 自定义业务方法 List<User> getActiveUsers(); } @Service public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService { @Override public List<User> getActiveUsers() { return lambdaQuery() .eq(User::getStatus, 1) .list(); } }

4. 高级特性应用

4.1 分页插件配置

必须注册分页插件才能生效：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

使用示例：

Page<User> page = new Page<>(1, 10); // 当前页,每页数量 userService.page(page, Wrappers.<User>query().eq("dept_id", 2));

4.2 性能优化技巧

1. 批量插入优化：

List<User> userList = new ArrayList<>(); // ...添加数据 userService.saveBatch(userList, 1000); // 每批1000条

2. Lambda表达式查询：

List<User> users = userService.lambdaQuery() .like(User::getName, "张") .between(User::getAge, 20, 30) .list();

5. 常见问题解决方案

5.1 多数据源配置

1. 添加多数据源依赖：

<dependency> <groupId>com.baomidou</groupId> <artifactId>dynamic-datasource-spring-boot-starter</artifactId> <version>3.5.1</version> </dependency>

2. 配置数据源：

spring: datasource: dynamic: primary: master datasource: master: url: jdbc:mysql://localhost:3306/db1 username: root password: 123456 slave: url: jdbc:mysql://localhost:3306/db2 username: root password: 123456

5.2 事务管理要点

1. 多数据源事务需要手动指定：

@DS("slave") // 指定数据源 @Transactional(rollbackFor = Exception.class) public void transfer() { // 业务逻辑 }

2. 注意事务失效场景：

• 同类方法调用（需通过AOP代理调用）
• 异常类型不匹配（默认只回滚RuntimeException）
• 事务传播行为配置错误

6. 生产环境建议

6.1 监控与日志

1. 开启执行SQL分析：

mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl max-time: 1000 # 慢查询阈值(ms)

2. 建议集成Prometheus监控：

@Bean public MeterRegistryCustomizer<MeterRegistry> metricsCommonTags() { return registry -> registry.config().commonTags("application", "myapp"); }

6.2 安全规范

1. 防止SQL注入：

• 始终使用参数化查询
• 禁用${}方式拼接SQL

2. 数据脱敏处理：

@JsonSerialize(using = SensitiveSerializer.class) private String idCard; // 身份证号自动脱敏

7. 扩展功能集成

7.1 代码生成器

配置示例：

AutoGenerator generator = new AutoGenerator(); generator.setGlobalConfig( new GlobalConfig.Builder() .outputDir("src/main/java") .author("developer") .build() ); // 数据源、包名等配置... generator.execute();

7.2 多租户实现

1. 添加租户拦截器：

public class TenantInterceptor implements InnerInterceptor { @Override public void beforeQuery(Executor executor, ...) { // 添加租户条件 } }

2. 注册拦截器：

interceptor.addInnerInterceptor(new TenantInterceptor());

8. 性能调优实战

8.1 连接池配置

推荐使用HikariCP：

spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000

8.2 二级缓存优化

1. 开启MyBatis二级缓存：

mybatis-plus: configuration: cache-enabled: true

2. 实体类添加注解：

@CacheNamespace public class User { ... }

9. 测试策略

9.1 单元测试规范

基础测试类示例：

@SpringBootTest @Transactional // 测试后自动回滚 class UserServiceTest { @Autowired private UserService userService; @Test void testSave() { User user = new User(); user.setName("test"); Assertions.assertTrue(userService.save(user)); } }

9.2 集成测试要点

1. 测试数据库准备：

@Testcontainers class IntegrationTest { @Container static MySQLContainer<?> mysql = new MySQLContainer<>("mysql:8.0"); @DynamicPropertySource static void configure(DynamicPropertyRegistry registry) { registry.add("spring.datasource.url", mysql::getJdbcUrl); } }

10. 部署与运维

10.1 Docker化部署

标准Dockerfile：

FROM openjdk:8-jdk-alpine ARG JAR_FILE=target/*.jar COPY ${JAR_FILE} app.jar ENTRYPOINT ["java","-jar","/app.jar"]

10.2 健康检查配置

SpringBoot Actuator配置：

management: endpoint: health: show-details: always endpoints: web: exposure: include: health,info

11. 版本升级指南

11.1 3.x版本迁移要点

1. 主要变更：

• 移除JSR310日期处理（需手动配置）
• 分页插件重构（需重新注册）
• 条件构造器API调整

2. 兼容性处理：

// 旧版 new QueryWrapper().eq("name", "test"); // 新版 Wrappers.query().eq("name", "test");

12. 源码解析与扩展

12.1 核心执行流程

1. SQL注入过程：

• MybatisPlusInterceptor拦截Executor方法
• 各InnerInterceptor按序处理
• 最终生成BoundSql执行

2. 关键扩展点：

• ISqlInjector（自定义SQL注入）
• IKeyGenerator（主键生成策略）
• IDialect（数据库方言）

13. 企业级实践

13.1 审计字段处理

自动填充配置：

@Component public class MetaHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); } }

13.2 数据权限控制

实现方案：

1. 自定义拦截器解析权限条件
2. 基于ThreadLocal传递权限参数
3. 动态修改查询SQL

14. 性能对比测试

14.1 基准测试数据

测试环境：MySQL 8.0，100万数据量

15. 最佳实践总结

1. 项目结构规范：

com.example.project ├── config # 配置类 ├── controller # 控制层 ├── service # 业务层 │ ├── impl # 实现类 ├── mapper # 数据层 ├── model # 实体类 │ ├── dto # 数据传输对象 │ ├── vo # 视图对象 └── util # 工具类

2. 编码规范建议：

• 实体类字段使用包装类型（避免NPE）
• Service方法返回Optional处理空值
• 控制器层只做参数校验和结果封装

3. 性能优化checklist：

• [ ] 启用批处理模式
• [ ] 合理设置连接池参数
• [ ] 添加合适的数据库索引
• [ ] 避免N+1查询问题

实际项目中，根据业务复杂度选择合适的功能组合。对于简单CRUD可直接使用ActiveRecord模式，复杂查询建议使用Lambda表达式保持类型安全。特别注意在多数据源环境下的事务一致性控制，必要时引入分布式事务解决方案