多数据源
默认数据库与依赖
框架默认使用 MySQL。如需使用其他数据库,请在 ruoyi-common-mybatis 模块的 pom.xml 中增加对应 JDBC 依赖。

补充说明:
- Cloud 版本的多数据源配置通常放在 Nacos 的
datasource.yml。 - 当前默认示例中常见的数据源 key 包括
system-master、gen、job、workflow。
多数据源事务
多数据源事务处理请参考 事务相关。
功能概览
多数据源框架官方文档:dynamic-datasource
- 支持 数据源分组 ,适用于多种场景 纯粹多库 读写分离 一主多从 混合模式。
- 支持数据库敏感配置信息 加密 ENC()。
- 支持每个数据库独立初始化表结构schema和数据库database。
- 支持无数据源启动,支持懒加载数据源(需要的时候再创建连接)。
- 支持 自定义注解 ,需继承DS(3.2.0+)。
- 提供并简化对Druid,HikariCp,BeeCp,Dbcp2的快速集成。
- 提供对Mybatis-Plus,Quartz,ShardingJdbc,P6sy,Jndi等组件的集成方案。
- 提供 自定义数据源来源 方案(如全从数据库加载)。
- 提供项目启动后 动态增加移除数据源 方案。
- 提供Mybatis环境下的 纯读写分离 方案。
- 提供使用 spel动态参数 解析数据源方案。内置spel,session,header,支持自定义。
- 支持 多层数据源嵌套切换 。(ServiceA >>> ServiceB >>> ServiceC)。
- 提供 基于seata的分布式事务方案。
- 提供 本地多数据源事务方案。 附:不能和原生spring事务混用。
用法说明
数据源加载顺序:方法 > 类 > 默认

补充说明:
- 使用方式与 Vue 版本一致,仍然是通过
@DS("数据源名")或 SpEL 表达式切换。 - 生成器模块同样使用了
@DS("#dataName")这类动态数据源写法。 - Cloud 版本只是在配置落点和默认数据源命名上与 Vue 版本不同,可直接参考 Vue 版本多数据源说明。
配置示例

异构数据库
示例:MySQL + Oracle。具体配置请参考官方文档。
