微服务初级项目应优先使用dynamic-datasource-spring-boot-starter而非手写AbstractRoutingDataSource,因其已封装ThreadLocal清理、事务识别和AOP切点等易错环节,配置简洁且天然兼容Spring Boot自动配置。

直接上结论:微服务初级项目里做MySQL多数据源动态切换,别自己手写AbstractRoutingDataSource——除非你明确要控制每个环节,否则优先用 dynamic-datasource-spring-boot-starter,它能覆盖 90% 的读写分离、双库并行、主从故障自动降级等场景,且和 Spring Boot 自动配置天然兼容。
为什么 starter 比手动配 AbstractRoutingDataSource 更适合初级项目
新手最容易卡在三件事上:ThreadLocal 泄漏、事务失效、AOP 切不到 Mapper 层。而 dynamic-datasource-spring-boot-starter 已经把这些封装好了:
- 它默认用
DataSourceContextHolder管理当前线程的数据源标识,且在每次请求结束时自动clear(),避免跨请求污染 - 它重写了
DataSourceTransactionManager的子类,能识别注解标记的数据源,保证@Transactional不会只管主库 - 它的 AOP 切点是
@DS注解所在的 Service 方法,不是 DAO 层,避开了 MyBatis-Plus 的代理链绕过问题 - 配置项全在
spring.datasource.dynamic下,不侵入原有spring.datasource主配置,升级或回滚成本低
application.yml 中最简可用配置长什么样
以下配置能立刻跑通一主一从(MySQL),不需要额外 Java 类:
spring:
datasource:
dynamic:
primary: master
strict: false
datasource:
master:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/db_master?useSSL=false&serverTimezone=UTC
username: root
password: 123456
slave:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/db_slave?useSSL=false&serverTimezone=UTC
username: root
password: 123456
注意几个关键点:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
strict: false表示当指定的@DS("slave")数据源不可用时,自动 fallback 到primary,这是初级项目防雪崩的关键开关 - 两个库的
driver-class-name必须显式写全,Spring Boot 2.4+ 后默认不推断 MySQL 驱动类,漏写会导致Cannot determine embedded database driver class for database type NONE - URL 中必须带
serverTimezone=UTC,否则高版本 MySQL 驱动会抛java.sql.SQLException: The server time zone value 'XXX' is unrecognized
@DS 注解该加在哪儿、怎么加才不踩坑
@DS 加的位置决定了切换粒度和事务行为,新手常错加在 Controller 或 Mapper 接口上:
- ✅ 正确位置:Service 层的 public 方法 上,且该方法必须被 Spring 容器管理(不能是 private / static / new 出来的对象调用)
- ❌ 错误示范:
@DS("slave")加在UserController.list()上——Controller 不参与事务,切换无效;加在UserMapper.selectById()上——MyBatis 动态代理不触发 AOP - ⚠️ 多层嵌套时:如果
AService.methodA()标了@DS("slave"),它内部调用的BService.methodB()默认仍走slave,除非BService.methodB()显式标了别的@DS - ? 读写分离场景建议:所有查询方法统一标
@DS("slave"),增删改标@DS("master")或不标(依赖primary默认值)
真正容易被忽略的是主从延迟导致的“刚写完就读不到”问题——这不是切换逻辑的 bug,而是架构约束。哪怕 @DS 切得再准,从库同步有秒级延迟时,业务上就得接受“最终一致性”,或者对强一致性操作主动路由到主库(比如用户注册后立即查自己信息,就得用 @DS("master"))。动态切换只是工具,不是银弹。










