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

Spring Boot 整合 MyBatis 实现多数据源，核心在于让不同业务操作精准命中对应数据库，而不是所有 SQL 都往一个库上撞。关键不是堆配置，而是理清“谁用哪个库、什么时候切、怎么切得稳”。下面分几块说清楚。

明确多数据源的典型使用场景

先想明白为什么需要多数据源，再动手配——避免为配而配：

• 读写分离：增删改走主库（master），查询走从库（slave），缓解主库压力
• 业务垂直拆分：用户数据放 user_db，订单数据放 order_db，物理隔离防耦合
• 对接第三方系统：自有业务库 + 第三方提供的只读库（如报表库、外部接口库）

选对方案：静态分包 or 动态切换

两种主流方式，适用不同节奏：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 分包方式（适合固定数据源）：按数据源划分 Mapper 包路径，比如 mapper.user.* 绑定 user 数据源，mapper.order.* 绑定 order 数据源；每个包单独配置 @MapperScan 和 SqlSessionFactory Bean
• 动态切换方式（推荐主流用法）：引入 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 真的走对了库