spring boot 集成 mybatis 的核心是“依赖引入 + 数据源配置 + mapper 扫描”,需添加 mybatis-spring-boot-starter 和数据库驱动,配置 application.yml 中的连接信息与 mybatis 参数,通过 @mapper 或 @mapperscan 注册接口,启动时验证日志与查询结果。

Spring Boot 集成 MyBatis 的核心是“依赖引入 + 数据源配置 + Mapper 扫描”,三步到位,无需 XML 配置类或繁琐的 SqlSessionFactory 手动注册。
添加 starter 依赖(关键一步)
在 pom.xml 中引入官方推荐的自动装配 starter:
- mybatis-spring-boot-starter:提供自动配置能力,含 SqlSessionFactory、SqlSessionTemplate 和 MapperScannerConfigurer
-
对应数据库驱动(如 MySQL):
mysql-connector-java,scope 必须设为 runtime - 可选但推荐:
spring-boot-starter-jdbc(已由 starter 间接引入,无需重复添加)
配置数据源与 MyBatis 参数
在 application.yml(更推荐)或 application.properties 中写入:
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
基础连接信息:URL、用户名、密码、driver-class-name(MySQL 8+ 推荐用
com.mysql.cj.jdbc.Driver) -
Mapper XML 路径(若使用 XML 方式):
mybatis.mapper-locations=classpath:mapper/*.xml -
实体类别名包(简化 XML 中 parameterType/resultType):
mybatis.type-aliases-package=com.example.entity -
开启 SQL 日志(调试用):
mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl
编写 Mapper 接口与映射文件(零配置启动)
MyBatis Starter 会自动扫描 @Mapper 注解接口或按包路径扫描所有 Mapper 接口:
- 在接口上加
@Mapper(适合少量 Mapper),或在启动类加@MapperScan("com.example.mapper")(推荐) - 接口方法直接定义,无需实现类;SQL 可写在注解中(
@Select)或外部 XML 文件里 - XML 文件需与接口同名、同包(或按
mybatis.mapper-locations指定路径存放),且namespace必须为接口全限定名
验证是否生效
启动项目后检查控制台日志:
- 出现
Started Application in X seconds且无数据库连接异常 - 有类似
MapperFactoryBean created for interface com.example.mapper.UserMapper的日志 - 调用接口时能正常查出数据,且 SQL 输出到控制台(开启 log-impl 后)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










