Spring Boot整合MyBatis-Plus最全指南：高效CRUD开发与避坑实战

前言

在Java企业级开发领域，MyBatis-Plus已成为提升数据库操作效率的利器。作为MyBatis的增强工具，它通过自动化CRUD操作、智能代码生成等特性，将开发者从重复劳动中解放出来。但在实际项目中，Spring Boot整合MyBatis-Plus时仍会遇到依赖冲突、配置陷阱等问题。本文将深入剖析整合流程，并针对常见难点提供解决方案。

一、Spring Boot整合MyBatis-Plus四步曲

1.1 添加核心依赖

在pom.xml中配置关键依赖（注意版本兼容性）：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.4</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.28</version>
</dependency>

1.2 配置数据源

application.yml配置示例（注意SSL模式禁用）：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mp_demo?useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

1.3 实体类与Mapper映射

@TableName("user")  // 注解声明表映射
public class User {
    @TableId(type = IdType.AUTO) // 主键策略
    private Long id;
    private String name;
    private Integer age;
}

public interface UserMapper extends BaseMapper<User> { } // 继承通用Mapper

1.4 启动类配置

@SpringBootApplication
@MapperScan("com.example.mapper") // 扫描Mapper接口
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

二、MyBatis-Plus省心技巧大全

2.1 分页插件配置

在配置类中启用分页插件：

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

2.2 代码生成器使用

通过代码生成器快速生成实体、Mapper、Service：

AutoGenerator generator = new AutoGenerator();
generator.setGlobalConfig(config)
         .setDataSource(dataSourceConfig)
         .setPackageInfo(packageConfig)
         .setStrategy(strategyConfig);
generator.execute(); // 一键生成基础代码

2.3 自动填充功能

public class MetaHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.setFieldValByName("createTime", new Date(), metaObject);
    }
}

三、Spring Boot整合四大难点解析

3.1 版本兼容性问题

典型错误现象：启动时出现NoSuchMethodError或ClassNotFoundException。
解决方案：

• 检查Spring Boot与MyBatis-Plus版本对应关系
• 使用mvn dependency:tree排查依赖冲突
• 参考官方版本兼容矩阵（如：Spring Boot 2.7.x对应MyBatis-Plus 3.5.x）

3.2 配置项遗漏

常见配置缺失：

• 未添加@MapperScan导致接口未被扫描
• 缺少分页插件配置导致分页失效
• 未配置逻辑删除全局值（mybatis-plus.global-config.db-config.logic-delete-value）

3.3 SQL注入防护

安全建议：

QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.apply("name = {0}", param) // 使用预编译方式
       .last("LIMIT 1");          // 避免直接拼接SQL

3.4 事务管理

整合Spring事务时注意：

1. 在Service层添加@Transactional注解
2. 避免在Mapper接口直接使用事务注解
3. 配置多数据源时需要特殊处理事务管理器

四、性能优化建议

1. 启用二级缓存：配置cache-enabled: true
2. 批处理优化：使用saveBatch方法替代循环插入
3. SQL日志控制：生产环境关闭SQL打印（mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.nologging.NoLoggingImpl）

结语

通过合理运用MyBatis-Plus的增强功能，开发者可以显著提升数据库操作效率。在实际项目中，建议结合具体业务场景选择合适的功能模块，同时注意规避版本兼容性等整合陷阱。本文配套示例代码已上传至GitHub（示例项目），欢迎参考实践。