SpringBoot-DynamicDataSource配置详解：主从数据源配置与轮询策略

SpringBoot-DynamicDataSource配置详解：主从数据源配置与轮询策略

【免费下载链接】SpringBoot-DynamicDataSourceDynamic datasource, multiple datasource of spring boot/ distribution transaction; spring boot 多数据源，动态数据源，分布式事务项目地址: https://gitcode.com/gh_mirrors/sp/SpringBoot-DynamicDataSource

SpringBoot-DynamicDataSource是一个强大的Spring Boot多数据源解决方案，它支持动态数据源切换和主从数据源配置，能够帮助开发者轻松实现分布式系统中的数据访问层设计。本文将详细介绍如何配置主从数据源以及实现从库轮询策略，让你的项目具备高可用的数据访问能力。

为什么需要主从数据源配置？

在现代应用架构中，数据库往往成为性能瓶颈。通过主从分离架构，我们可以将写操作集中在主库，读操作分散到多个从库，从而提高系统的并发处理能力和数据可用性。SpringBoot-DynamicDataSource提供了简单易用的主从数据源配置方式，让开发者无需复杂编码即可实现这一架构。

快速开始：环境准备

要使用SpringBoot-DynamicDataSource，首先需要克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/sp/SpringBoot-DynamicDataSource

项目采用Gradle构建，核心依赖包括Spring Boot和HikariCP连接池。确保你的开发环境中已安装JDK 8+和MySQL数据库。

主从数据源配置步骤

1. 配置文件设置

主从数据源的配置主要在src/main/resources/application.properties文件中完成。该文件中定义了主库和多个从库的连接信息：

# 主数据源配置 spring.datasource.hikari.master.name=master spring.datasource.hikari.master.driver-class-name=com.mysql.jdbc.Driver spring.datasource.hikari.master.jdbc-url=jdbc:mysql://localhost/product_master?useSSL=false spring.datasource.hikari.master.port=3306 spring.datasource.hikari.master.username=root spring.datasource.hikari.master.password=123456 # 从数据源配置 - SlaveAlpha spring.datasource.hikari.slave-alpha.name=SlaveAlpha spring.datasource.hikari.slave-alpha.jdbc-url=jdbc:mysql://localhost/product_slave_alpha?useSSL=false # 从数据源配置 - SlaveBeta spring.datasource.hikari.slave-beta.name=SlaveBeta spring.datasource.hikari.slave-beta.jdbc-url=jdbc:mysql://localhost/product_slave_beta?useSSL=false # 从数据源配置 - SlaveGamma spring.datasource.hikari.slave-gamma.name=SlaveGamma spring.datasource.hikari.slave-gamma.jdbc-url=jdbc:mysql://localhost/product_slave_gamma?useSSL=false

配置文件中使用了HikariCP连接池，通过不同的前缀区分主库和各个从库。你需要根据实际环境修改数据库URL、用户名和密码。

2. 数据源配置类

项目中的src/main/java/cn/com/hellowood/dynamicdatasource/configuration/DataSourceConfigurer.java类负责数据源的配置和初始化。该类通过@ConfigurationProperties注解将配置文件中的属性绑定到数据源对象，并设置主数据源为默认数据源：

@ConfigurationProperties(prefix = "spring.datasource.hikari.master") public DataSource masterDataSource() { return new HikariDataSource(); } @Bean @ConfigurationProperties(prefix = "spring.datasource.hikari.slave-alpha") public DataSource slaveAlphaDataSource() { return new HikariDataSource(); } // 其他从数据源配置...

3. 动态数据源路由

DynamicRoutingDataSource类继承自Spring的AbstractRoutingDataSource，负责根据上下文动态选择数据源。它通过determineCurrentLookupKey方法获取当前线程的数据源键，从而实现数据源的动态切换。

从库轮询策略实现

SpringBoot-DynamicDataSource采用轮询策略来分发从库的读请求，实现负载均衡。这一策略在DynamicDataSourceContextHolder类中实现：

public static void useSlaveDataSource() { try { int datasourceKeyIndex = counter % slaveDataSourceKeys.size(); CONTEXT_HOLDER.set(String.valueOf(slaveDataSourceKeys.get(datasourceKeyIndex))); counter++; } catch (Exception e) { logger.error("Switch slave datasource failed, error message is {}", e.getMessage()); useMasterDataSource(); e.printStackTrace(); } }

上述代码通过计数器和取模运算实现了从库的轮询选择。当切换从库失败时，系统会自动切换到主库，保证系统的可用性。

数据源切换的使用方式

1. 注解方式

项目提供了AOP切面DynamicDataSourceAspect，通过拦截Mapper接口的方法调用，自动切换数据源。默认情况下，写操作使用主库，读操作使用从库：

@Pointcut("execution( * cn.com.hellowood.dynamicdatasource.mapper.*.*(..))") public void dataSourcePointCut() {} @Around("dataSourcePointCut()") public Object around(ProceedingJoinPoint point) throws Throwable { // 根据方法名判断是读操作还是写操作，选择相应的数据源 // ... }

2. 手动切换

你也可以在代码中手动切换数据源：

// 使用主库 DynamicDataSourceContextHolder.useMasterDataSource(); // 使用从库（轮询选择） DynamicDataSourceContextHolder.useSlaveDataSource(); // 手动指定数据源 DynamicDataSourceContextHolder.setDataSourceKey("SlaveAlpha");

常见问题解决

1. 数据源切换不生效

如果遇到数据源切换不生效的问题，首先检查DataSourceConfigurer类中是否正确配置了SqlSessionFactory：

sqlSessionFactoryBean.setDataSource(dynamicDataSource());

确保将动态数据源设置到SqlSessionFactory中，这是实现数据源切换的关键步骤。

2. 从库轮询不均匀

如果发现从库负载不均衡，可以检查DynamicDataSourceContextHolder类中的计数器实现，确保其线程安全性。项目中使用的counter变量是静态的，可能会导致并发环境下的计数不准确，可以考虑使用原子类来优化。

总结

SpringBoot-DynamicDataSource提供了一种简单高效的方式来实现Spring Boot应用的多数据源配置和动态切换。通过本文介绍的主从数据源配置和轮询策略，你可以轻松构建高可用、高性能的数据访问层。项目的核心代码位于src/main/java/cn/com/hellowood/dynamicdatasource/configuration/目录下，包括数据源配置、动态路由和切换策略等关键实现。

无论是小型项目还是大型分布式系统，SpringBoot-DynamicDataSource都能满足你的多数据源需求，帮助你构建更健壮的应用系统。赶快尝试使用吧！

【免费下载链接】SpringBoot-DynamicDataSourceDynamic datasource, multiple datasource of spring boot/ distribution transaction; spring boot 多数据源，动态数据源，分布式事务项目地址: https://gitcode.com/gh_mirrors/sp/SpringBoot-DynamicDataSource