RuoYi-Vue多数据源配置：动态切换数据源完整方案

管翔渊Lacey

1045人浏览 · 2026-05-02 08:48:28

管翔渊Lacey · 2026-05-02 08:48:28 发布

RuoYi-Vue多数据源配置：动态切换数据源完整方案

【免费下载链接】RuoYi-Vue :tada: (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue & Element 的前后端分离权限管理系统，同时提供了 Vue3 的版本项目地址: https://gitcode.com/gh_mirrors/ruoyiv/RuoYi-Vue

RuoYi-Vue是一款基于SpringBoot、Spring Security、JWT、Vue & Element的前后端分离权限管理系统，提供了强大的动态数据源配置功能，让开发者能够轻松实现多数据源的动态切换，满足复杂业务场景的数据访问需求。

多数据源配置的核心价值

在企业级应用开发中，多数据源配置是应对复杂业务场景的关键技术。无论是读写分离、分库分表，还是不同业务模块使用独立数据库，RuoYi-Vue的动态数据源方案都能提供高效、灵活的解决方案，帮助开发者轻松构建高可用的分布式系统。

快速入门：RuoYi-Vue多数据源配置基础

核心组件解析

RuoYi-Vue的多数据源功能主要依赖于以下核心组件：

DynamicDataSource：继承自AbstractRoutingDataSource，负责动态路由到目标数据源
DynamicDataSourceContextHolder：管理数据源上下文，存储当前线程使用的数据源标识
DataSourceAspect：通过AOP实现数据源注解的解析和切换

这些组件协同工作，实现了数据源的动态切换功能，其代码实现位于ruoyi-framework/src/main/java/com/ruoyi/framework/datasource/目录下。

配置文件设置

在RuoYi-Vue中，数据源配置主要通过DruidConfig类实现。该类使用@Configuration注解标识为配置类，并通过@ConfigurationProperties注解读取配置文件中的数据源信息：

@Configuration
public class DruidConfig {
    @Bean
    @ConfigurationProperties("spring.datasource.druid.master")
    public DataSource masterDataSource(DruidProperties druidProperties) {
        // 主数据源配置
    }
    
    @Bean
    @ConfigurationProperties("spring.datasource.druid.slave")
    @ConditionalOnProperty(prefix = "spring.datasource.druid.slave", name = "enabled", havingValue = "true")
    public DataSource slaveDataSource(DruidProperties druidProperties) {
        // 从数据源配置
    }
    
    @Bean(name = "dynamicDataSource")
    public DynamicDataSource dataSource(DataSource masterDataSource) {
        // 动态数据源配置
    }
}

完整代码可查看ruoyi-framework/src/main/java/com/ruoyi/framework/config/DruidConfig.java。

实战指南：动态切换数据源的3种方式

方式一：使用@DataSource注解

RuoYi-Vue提供了@DataSource注解，可直接标注在Service方法上，指定该方法使用的数据源：

@Service
public class SysConfigServiceImpl implements ISysConfigService {
    @Override
    @DataSource(DataSourceType.MASTER)
    public List<SysConfig> selectConfigList(SysConfig config) {
        // 使用主数据源查询配置列表
        return configMapper.selectConfigList(config);
    }
}

这种方式简单直观，适合在方法级别灵活指定数据源。示例代码来自ruoyi-system/src/main/java/com/ruoyi/system/service/impl/SysConfigServiceImpl.java。

方式二：手动切换数据源

通过DynamicDataSourceContextHolder类提供的静态方法，可以在代码中手动切换数据源：

// 切换到从数据源
DynamicDataSourceContextHolder.setDataSourceType(DataSourceType.SLAVE.name());
try {
    // 执行数据库操作
} finally {
    // 清除数据源上下文，恢复默认数据源
    DynamicDataSourceContextHolder.clearDataSourceType();
}

这种方式适合需要在方法内部动态切换数据源的场景，但要注意在finally块中清除数据源上下文，避免影响后续操作。

方式三：全局默认数据源配置

在DruidConfig中，可以配置全局默认数据源，当没有指定数据源时，将使用默认数据源：

@Bean(name = "dynamicDataSource")
public DynamicDataSource dataSource(DataSource masterDataSource) {
    Map<Object, Object> targetDataSources = new HashMap<>();
    targetDataSources.put(DataSourceType.MASTER.name(), masterDataSource);
    // 添加从数据源
    if (StringUtils.isNotNull(slaveDataSource)) {
        targetDataSources.put(DataSourceType.SLAVE.name(), slaveDataSource);
    }
    // 设置默认数据源为MASTER
    return new DynamicDataSource(masterDataSource, targetDataSources);
}

高级技巧：多数据源配置最佳实践

读写分离配置

利用RuoYi-Vue的多数据源功能，可以轻松实现数据库读写分离：

配置主库（写库）和从库（读库）数据源
在写操作方法上添加@DataSource(DataSourceType.MASTER)注解
在读操作方法上添加@DataSource(DataSourceType.SLAVE)注解

这种配置可以有效减轻主库压力，提高系统性能。

多数据源事务管理

在多数据源环境下，事务管理需要特别注意。RuoYi-Vue推荐使用编程式事务管理，确保事务的一致性：

@Transactional
public void saveData() {
    // 操作主数据源
    masterMapper.insert(data);
    
    // 切换到从数据源
    DynamicDataSourceContextHolder.setDataSourceType(DataSourceType.SLAVE.name());
    try {
        // 操作从数据源
        slaveMapper.insert(data);
    } finally {
        DynamicDataSourceContextHolder.clearDataSourceType();
    }
}

数据源监控与管理

RuoYi-Vue集成了Druid数据源监控功能，可以通过ruoyi-ui/src/views/monitor/druid/index.vue页面查看数据源的运行状态，包括连接数、SQL执行情况等关键指标，帮助开发者及时发现和解决问题。

常见问题与解决方案

数据源切换不生效

如果遇到数据源切换不生效的问题，可以从以下几个方面排查：

检查@DataSource注解是否正确添加在Service方法上
确认数据源类型是否在DynamicDataSource中正确配置
检查是否有事务传播导致数据源上下文被覆盖

多数据源下的分页问题

在多数据源环境下使用分页插件时，需要确保分页插件配置正确。RuoYi-Vue的MyBatisConfig中已经配置了分页插件，支持多数据源环境：

@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
    return interceptor;
}

完整代码可查看ruoyi-framework/src/main/java/com/ruoyi/framework/config/MyBatisConfig.java。