Spring Boot 配合 MyBatis-Plus 实现多数据源应使用 dynamic-datasource-spring-boot-starter 组件，通过 application.yml 配置多数据源、@DS 注解声明式切换，支持混用数据库、分页自动适配方言、事务单库生效及扩展场景如多租户和热加载。
Spring Boot 配合 MyBatis-Plus 实现多数据源，核心是用 dynamic-datasource-spring-boot-starter 这个轻量、成熟、开箱即用的组件，而不是手动写 AbstractRoutingDataSource 或硬编码切换逻辑。它把数据源定义、路由、事务兼容、分页适配都封装好了，业务层只需加一个 @DS 注解就能精准控制走哪个库。
依赖与基础配置
在 pom.xml 中引入官方推荐的 starter：
-
mybatis-plus-boot-starter（版本需匹配 Spring Boot，如 2.7.x 对应 MP 3.5.x） -
dynamic-datasource-spring-boot-starter（推荐 3.6.1+，兼容性好、文档全）
application.yml 中直接声明多个数据源，无需写 Java 配置类：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
spring.datasource.dynamic.primary指定默认数据源名（如master） -
spring.datasource.dynamic.datasource.{name}下配置每个库的完整 JDBC 参数 - 支持混用不同数据库：MySQL + Oracle、MySQL + SQLServer、PostgreSQL + MySQL 等
- Oracle 驱动要显式指定
driver-class-name: oracle.jdbc.OracleDriver，避免 Spring Boot 自动加载 ojdbc8 导致兼容问题
@DS 注解实现精准切换
切换完全声明式，不侵入业务逻辑：
- 加在
@Service类上：整个类所有方法默认走该数据源 - 加在具体方法上：覆盖类级配置，优先级更高
- 例如：写操作标
@DS("master")，报表查询标@DS("report")，历史归档查标@DS("archive") - 注解值必须和 yml 中定义的 data source 名称完全一致（区分大小写）
关键细节与避坑点
很多“能启动但查不到数据”“事务失效”“分页总数错”的问题，都出在这些地方：
-
Mapper 扫描范围不用改：dynamic-datasource 会自动为每个数据源创建独立 SqlSessionFactory，MyBatis-Plus 的
@MapperScan保持原样即可 - 事务只对单数据源生效：跨库操作无法用 @Transactional 保证强一致性，需要改用 Seata 或业务层补偿
-
分页插件自动识别当前数据源方言：比如
@DS("sqlserver")下的page.selectList()会生成 SQLServer 分页语法，无需额外配置 - 线程隔离靠 InheritableThreadLocal：@DS 切换是方法级的，不会污染其他线程；异步任务（如 @Async）需手动传递数据源上下文
扩展场景支持
这套方案不止于读写分离，还能支撑更复杂的落地需求：
-
多租户：结合请求头或 token 解析 tenantId，用 AOP 动态调用
DynamicDataSourceContextHolder.push("tenant_001") -
故障自动降级：配置
spring.datasource.dynamic.strict=false，数据源不可用时不抛异常，可 fallback 到备用库 -
运行时热加载：调用
/actuator/datasource端点（需开启 actuator）动态增删数据源，适合对接配置中心
