讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

如何在微服务初级项目中实现MySQL多数据源动态切换?

大伟吖_2493

大伟吖_2493

发布时间:2026-11-17 08:53:37

|

840人浏览过

|

来源于php中文网

原创

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

如何在微服务初级项目中实现mysql多数据源动态切换?

直接上结论:微服务初级项目里做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 类:

win可用的mysql指令skill
win可用的mysql指令skill

安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。

下载
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

注意几个关键点:

  • 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"))。动态切换只是工具,不是银弹。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2653

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1579

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

935

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3792

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

6648

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1379

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6911

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

5882

2023.08.14

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn