讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在SpringBoot项目中配置MySQL的双数据源?

胖静吖_4123

胖静吖_4123

发布时间:2026-06-21 08:54:01

|

578人浏览过

|

来源于php中文网

原创

能配,但需严格遵循配置规范:数据源须用不同前缀(如master/slave)隔离,事务管理器一对一绑定并标注@Primary,SqlSessionFactory必须明确指定对应数据源,AbstractRoutingDataSource需清理ThreadLocal上下文。

如何在springboot项目中配置mysql的双数据源?

能配,但别直接抄网上“两段@Configuration+@Primary”的模板——90%的线上事故都出在事务管理器没对齐、MyBatis的SqlSessionFactory绑定错源、或者AbstractRoutingDataSource里线程上下文没清理干净。

application.yml 里数据源配置必须带明确前缀

Spring Boot 不会自动识别“两个 spring.datasource”,必须用不同前缀隔离,否则后加载的会覆盖前一个:

  • spring.datasource.master 和 spring.datasource.slave 是最安全的命名方式,避免和 Spring Boot 自动配置的默认 spring.datasource 冲突
  • 每个数据源必须单独指定 driver-class-name,MySQL 8+ 必须用 com.mysql.cj.jdbc.Driver,旧版驱动在高并发下可能抛 SQLException: Connection is closed
  • url 中的 serverTimezone=Asia/Shanghai 和 useUnicode=true&characterEncoding=utf-8 缺一不可,否则中文入库乱码或时间字段偏移

事务管理器必须一对一绑定数据源

一个 DataSource 就得配一个 PlatformTransactionManager,否则 @Transactional 注解会静默失效:

SpringBoot升级-BW
SpringBoot升级-BW

将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程,覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。

下载
  • 主库事务管理器必须标注 @Primary,否则 Spring 无法决定默认用哪个
  • 从库操作如果也加了 @Transactional,必须显式指定管理器名:@Transactional("slaveTransactionManager")
  • 千万别把两个 DataSourceTransactionManager 都设为 @Primary,Spring 启动直接报 NoUniqueBeanDefinitionException

MyBatis 的 SqlSessionFactory 和 MapperScan 要严格隔离

MyBatis 不会自动按数据源分发 SQL,必须手动切断绑定链:

  • 每个 SqlSessionFactory Bean 必须明确 setDataSource() 到对应数据源实例,不能共用
  • @MapperScan 的 basePackages 和 sqlSessionFactoryRef 必须成对出现:主库 mapper 扫描路径只能引用主库的 SqlSessionFactory,反之亦然
  • 如果用了 MyBatis-Plus,MybatisPlusAutoConfiguration 会抢注默认 SqlSessionFactory,必须在 spring.autoconfigure.exclude 里排除它,否则启动报 BeanDefinitionOverrideException

动态路由必须处理好线程上下文泄漏

用 AbstractRoutingDataSource 实现读写分离时,getTargetDataSource() 返回的只是数据源引用,真正切换靠的是 ThreadLocal 存的 key —— 这个 key 不清理,一次请求残留会影响后续请求:

  • 务必在过滤器或拦截器里调用 DynamicDataSourceContextHolder.clear()(或你自定义的清空方法),且放在 finally 块中
  • 不要在异步线程(如 @Async 方法)里触发数据源切换,ThreadLocal 不传递,会 fallback 到默认源
  • 事务方法内先查后写,比如 @Transactional 里调 slaveMapper.selectById() 再调 masterMapper.update(),必须确保查操作发生在写之前,否则从库可能读不到刚写入的主库数据(最终一致性窗口)

最常被跳过的点是事务管理器和 SqlSessionFactory 的绑定关系——配错一个,整个数据源就形同虚设,SQL 全走默认源,连日志都看不出异常。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

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

WorkBuddy

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

豆包大模型

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

PixPix
PixPix Hot

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

Loomy
Loomy Hot

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

2293

2023.06.20

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

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

1399

2023.06.21

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

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

835

2023.07.18

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

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

3192

2023.07.19

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

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

5408

2023.07.25

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

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

1199

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

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

5671

2023.08.11

mysql忘记密码
mysql忘记密码

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

4942

2023.08.14

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Redis6入门到精通超详细教程
Redis6入门到精通超详细教程

共47课时 | 7.3万人学习

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

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