Spring Boot 集成 MyBatis-Plus 核心三步:加依赖(按 Boot 版本选 starter)、配数据源(application.yml 中配置连接及日志)、写实体(@TableName/@TableId)和 Mapper(继承 BaseMapper 并加 @Mapper)。

Spring Boot 集成 MyBatis-Plus 很简单,核心就三步:加依赖、配数据源、写实体和 Mapper。它不是替代 MyBatis,而是让你少写重复 SQL——单表 CRUD 直接调用方法,复杂查询仍可手写 XML 或自定义 SQL。
添加 starter 依赖
在 pom.xml 中引入官方启动器(注意 Spring Boot 版本匹配):
- Spring Boot 2.x 项目用:
<dependency><br> <groupId>com.baomidou</groupId><br> <artifactId>mybatis-plus-boot-starter</artifactId><br> <version>3.5.5</version><br></dependency>
- Spring Boot 3.x 项目用:
<dependency><br> <groupId>com.baomidou</groupId><br> <artifactId>mybatis-plus-spring-boot3-starter</artifactId><br> <version>最新稳定版</version><br></dependency>
- 别再额外引入
mybatis-spring-boot-starter或原生 MyBatis,会冲突
配置数据库连接
在 application.yml 中写好数据源和 MP 基础设置:
在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。
- 数据源部分必须包含
url、username、password和driver-class-name(MySQL 8+ 推荐用com.mysql.cj.jdbc.Driver) - 加上
mybatis-plus.configuration.log-impl: org.apache.ibatis.logging.stdout.StdOutImpl,方便控制台看 SQL - 如需自动填充、逻辑删除等高级功能,可在
mybatis-plus.global-config.db-config下开启对应开关
编写实体类与 Mapper 接口
这是最轻量的一步,不需要 XML:
- 实体类加
@TableName("user")映射表名,主键字段加@TableId(type = IdType.AUTO) - Mapper 接口继承
BaseMapper<user></user>,并加上@Mapper注解(或在启动类加@MapperScan扫描包) - 不用写任何实现类,CRUD 方法已内置,比如
selectById、insert、updateById、deleteById
验证是否跑通
写个简单测试即可确认集成成功:
- 用
@SpringBootTest注入你的 Mapper - 调用
selectList(null)查全部数据,看控制台是否打印出 SQL 和结果列表 - 如果报
Cannot find class或Mapper not found,重点检查注解是否遗漏、包路径是否被扫描到、依赖是否版本错配

















