1. SpringBoot整合MyBatis-Plus完整方案解析

作为Java开发者最常用的ORM框架组合，SpringBoot与MyBatis-Plus的整合能显著提升持久层开发效率。最近在重构公司老旧项目时，我完整走通了从依赖配置到功能测试的全流程，过程中发现不少官方文档未明确说明的细节问题。本文将基于SpringBoot 3.1.5和MyBatis-Plus 3.5.3.1版本，详解企业级项目中的标准整合姿势。

2. 环境准备与依赖配置

2.1 项目初始化要点

创建SpringBoot项目时，建议使用IDEA内置的Spring Initializr，注意勾选以下核心依赖：

• Spring Web（用于接口测试）
• Lombok（简化实体类编写）
• MySQL Driver（根据实际数据库选配）

关键提示：不要勾选MyBatis官方starter！这与MyBatis-Plus的starter存在冲突风险

2.2 精准依赖管理

在pom.xml中需要添加的核心依赖如下：

<!-- MyBatis-Plus SpringBoot3专用starter --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-spring-boot3-starter</artifactId> <version>3.5.3.1</version> </dependency> <!-- 分页插件（非必须但推荐） --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-extension</artifactId> <version>3.5.3.1</version> </dependency>

常见版本匹配问题解决方案：

• SpringBoot2.x → mybatis-plus-boot-starter
• SpringBoot3.x → mybatis-plus-spring-boot3-starter
• SpringBoot3.5.13+ → mybatis-plus-spring-boot4-starter

3. 关键配置详解

3.1 数据源配置模板

application.yml标准配置示例：

spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/demo?useSSL=false&serverTimezone=Asia/Shanghai username: root password: 123456 hikari: maximum-pool-size: 20 minimum-idle: 5 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启SQL日志 global-config: db-config: id-type: auto # 主键自增策略 logic-delete-field: deleted # 逻辑删除字段 logic-not-delete-value: 0 logic-delete-value: 1

3.2 扫描路径配置陷阱

启动类注解的常见错误写法：

@MapperScan("com.example.mapper") // 可能扫描不到子模块

推荐使用全路径扫描：

@MapperScan({ "com.example.**.mapper", "com.baomidou.mybatisplus.samples.**.mapper" })

4. 核心功能实现

4.1 实体类最佳实践

@Data @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(fill = FieldFill.INSERT) private LocalDateTime createTime; @Version private Integer version; }

踩坑记录：@TableField的condition属性在连表查询时不生效，需要手动在Wrapper中指定

4.2 Mapper接口增强方案

基础接口继承：

public interface UserMapper extends BaseMapper<User> { // 自定义复杂查询 @Select("SELECT * FROM user WHERE age > #{age}") List<User> selectCustom(@Param("age") Integer age); }

4.3 服务层封装技巧

public interface IUserService extends IService<User> { Page<User> selectPageVo(Page<User> page, Integer state); } @Service public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService { @Override public Page<User> selectPageVo(Page<User> page, Integer state) { return baseMapper.selectPageVo(page, state); } }

5. 高级功能集成

5.1 分页插件配置

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 分页插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); // 乐观锁插件 interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor()); return interceptor; } }

5.2 自定义SQL注入器

实现逻辑删除增强：

public class LogicSqlInjector extends DefaultSqlInjector { @Override public List<AbstractMethod> getMethodList(Class<?> mapperClass) { List<AbstractMethod> methodList = super.getMethodList(mapperClass); methodList.add(new LogicDeleteByIdWithFill()); return methodList; } }

6. 常见问题排查指南

6.1 依赖冲突解决方案

典型冲突表现：

• 启动报错BeanCreationException
• SQL执行时报方法不存在

排查命令：

mvn dependency:tree -Dincludes=mybatis

解决方案：

<exclusions> <exclusion> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> </exclusion> <exclusion> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> </exclusion> </exclusions>

6.2 性能优化建议

1. 批量操作使用executeBatch：

sqlSessionFactory.openSession(ExecutorType.BATCH)

2. 复杂查询关闭自动映射：

@TableField(exist = false) private String transientField;

3. 启用二级缓存：

mybatis-plus: configuration: cache-enabled: true

7. 生产环境注意事项

1. 监控指标暴露：

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

2. 慢SQL预警配置：

@Bean public PerformanceInterceptor performanceInterceptor() { PerformanceInterceptor interceptor = new PerformanceInterceptor(); interceptor.setMaxTime(1000); // 超过1秒记录警告 interceptor.setFormat(true); return interceptor; }

3. 多租户方案实现：

public class TenantInterceptor implements InnerInterceptor { @Override public void beforeQuery(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) { // 自动添加tenant_id条件 } }

经过三个月的生产环境验证，这套整合方案在日均百万级请求量的系统中表现稳定。特别提醒：在SpringBoot3.x环境下，务必使用对应的starter版本，否则会出现不可预知的兼容性问题。对于复杂查询场景，建议结合QueryDSL使用，能获得更好的类型安全性和可维护性。