Spring Boot 整合 MyBatis 实现多数据源的核心是精准路由,需明确场景(读写分离、业务拆分、第三方对接),优选 dynamic-datasource 动态切换方案,通过 @DS 注解指定数据源,并注意事务限制、Druid 监控及默认源配置。

Spring Boot 整合 MyBatis 实现多数据源,核心在于让不同业务操作精准命中对应数据库,而不是所有 SQL 都往一个库上撞。关键不是堆配置,而是理清“谁用哪个库、什么时候切、怎么切得稳”。下面分几块说清楚。
明确多数据源的典型使用场景
先想明白为什么需要多数据源,再动手配——避免为配而配:
- 读写分离:增删改走主库(master),查询走从库(slave),缓解主库压力
-
业务垂直拆分:用户数据放
user_db,订单数据放order_db,物理隔离防耦合 - 对接第三方系统:自有业务库 + 第三方提供的只读库(如报表库、外部接口库)
选对方案:静态分包 or 动态切换
两种主流方式,适用不同节奏:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
分包方式(适合固定数据源):按数据源划分 Mapper 包路径,比如
mapper.user.*绑定 user 数据源,mapper.order.*绑定 order 数据源;每个包单独配置@MapperScan和SqlSessionFactoryBean -
动态切换方式(推荐主流用法):引入
dynamic-datasource-spring-boot-starter,通过@DS("xxx")注解在 Service 层直接指定数据源,无需改包结构,支持类级/方法级切换
快速落地:用 dynamic-datasource 实现动态切换
这是目前最轻量、最易维护的方式,三步到位:
-
加依赖:pom.xml 中引入
com.baomidou:dynamic-datasource-spring-boot-starter:3.6.1 -
写配置:application.yml 里定义多个数据源,标注
primary默认源,例如:
spring:
datasource:
dynamic:
primary: master
datasource:
master: {...}
slave: {...}
order: {...} -
打注解:在 Service 方法或类上加
@DS("slave")或@DS("order"),MyBatis-Plus 自动路由到对应数据源
注意事项和避坑点
配置跑通不等于线上稳定,这些细节决定成败:
- 事务慎跨库:Spring 的本地事务(@Transactional)只对单个数据源生效,跨库操作需考虑分布式事务方案(如 Seata),或重构为单库事务+异步补偿
-
Druid 可选但建议加:搭配
druid-spring-boot-starter能监控连接池状态、SQL 执行耗时,排查慢查更直观 -
默认数据源必须存在:即使你总用
@DS指定,也要配置一个primary数据源,否则启动失败 -
SQL 日志别关:开启
mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl,确认实际执行的 SQL 真的走对了库

















