mybatis多数据源切换依赖spring的abstractroutingdatasource实现动态路由，核心是通过threadlocal存储数据源标识、aop/注解触发切换、sqlsessionfactory绑定逻辑数据源，并确保切换在事务开始前完成且同一事务内不可更换数据源。
MyBatis 在多数据源切换场景中，主要依靠 Spring 的 AbstractRoutingDataSource 做动态路由，而不是 MyBatis 自身直接管理数据源。核心思路是：让 MyBatis 的 SqlSessionFactory 绑定到一个“逻辑数据源”，这个逻辑数据源背后由 AbstractRoutingDataSource 根据运行时规则，动态选择真实的数据源（如 master、slave）。
关键组件与职责分工
要跑通这套机制，需协同以下几部分：
- 多个真实 DataSource Bean：比如 druid 或 hikari 连接池实例，分别对应不同数据库（如主库、从库、业务库）；
-
DynamicDataSource 继承 AbstractRoutingDataSource：重写
determineCurrentLookupKey()，它决定当前线程该用哪个真实数据源； - ThreadLocal 管理上下文：通过静态工具类（如 DataSourceContextHolder）在线程内暂存数据源标识（如 "master"），供 determineCurrentLookupKey 读取；
- SqlSessionFactory 指向 DynamicDataSource：MyBatis 只认这一个数据源，所有 SQL 执行都经它路由；
- AOP 或注解触发切换：在 service 方法上加 @DataSource("slave")，AOP 拦截并调用 DataSourceContextHolder.set("slave")。
切换时机与事务约束
数据源切换发生在获取 Connection 的瞬间，即 MyBatis 调用 getConnection() 时，不是在 SQL 解析或执行后。这意味着：
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 切换必须在事务开启前完成——@Transactional 方法内无法中途换数据源，否则会抛出异常或连接不一致；
- 同一个事务只能绑定一个数据源，跨库事务需靠分布式事务方案（如 Seata）；
- 若方法未显式指定，默认走 DynamicDataSource 配置的 defaultTargetDataSource。
典型配置结构示例
Spring Boot 中常见配置模式如下：
- application.yml 中定义多个数据源配置（如 spring.datasource.druid.master / .slave）；
- @Configuration 类中用 @Bean 声明两个 DataSource 实例，并注入到 DynamicDataSource 构造器；
- DynamicDataSource 构造时传入 targetDataSources（Map
）和 defaultTargetDataSource； - SqlSessionFactoryBuilder 使用该 DynamicDataSource 构建 SqlSessionFactory；
- 事务管理器 PlatformTransactionManager 也需指向同一 DynamicDataSource，否则事务失效。
常见踩坑点
实际落地时容易忽略这些细节：
- 忘记在方法结束时调用
DataSourceContextHolder.clear()，导致线程复用时污染后续请求； - AOP 切面未覆盖到内部调用（private 方法或 this.调用），造成切换失效；
- 使用了 @Async 或新启线程，但没手动传递 ThreadLocal 上下文；
- 多个数据源用了相同 transaction-manager 名称，Spring 容器注入冲突；
- MyBatis-Plus 等封装框架默认只配一个 SqlSessionFactory，需确认是否适配多数据源路由逻辑。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
