当前位置：首页 > news >正文

Spring Boot多数据源配置详解

news 2025/7/10 13:31:04

Spring Boot多数据源配置详解

在实际企业开发中，随着业务复杂度提升，单一数据源已无法满足所有场景需求。比如：读写分离、分库分表、数据迁移、微服务整合等，这时就需要用到多数据源配置。本文将从原理、配置、常见问题和最佳实践等方面，带你全面掌握Spring Boot多数据源的实现方式。

一、为什么要用多数据源？

读写分离：主库写、从库读，提升性能与可用性。
多业务数据库：不同业务模块独立数据库，降低耦合。
数据迁移/整合：新旧系统并行，数据同步。
多租户/分库分表：按租户或业务分库，提升扩展性。

二、Spring Boot多数据源实现原理

Spring Boot默认只配置一个DataSource，多数据源本质上是注册多个DataSource Bean，并通过@Primary、@Qualifier等注解区分。每个数据源对应自己的JdbcTemplate、TransactionManager、MyBatis或JPA配置。

三、实战：Spring Boot多数据源配置

1. 添加依赖

以MySQL和MyBatis为例：

<!-- pom.xml -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.3.0</version>
</dependency>

2. 配置多数据源

# application.yml
spring:datasource:primary:url: jdbc:mysql://localhost:3306/db1username: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Driversecondary:url: jdbc:mysql://localhost:3306/db2username: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Driver

3. 编写数据源配置类

@Configuration
@MapperScan(basePackages = "com.example.mapper.db1", sqlSessionTemplateRef = "primarySqlSessionTemplate")
public class PrimaryDataSourceConfig {@Bean(name = "primaryDataSource")@ConfigurationProperties(prefix = "spring.datasource.primary")public DataSource primaryDataSource() {return DataSourceBuilder.create().build();}@Bean(name = "primarySqlSessionFactory")public SqlSessionFactory primarySqlSessionFactory(@Qualifier("primaryDataSource") DataSource dataSource) throws Exception {SqlSessionFactoryBean bean = new SqlSessionFactoryBean();bean.setDataSource(dataSource);return bean.getObject();}@Bean(name = "primaryTransactionManager")public DataSourceTransactionManager primaryTransactionManager(@Qualifier("primaryDataSource") DataSource dataSource) {return new DataSourceTransactionManager(dataSource);}@Bean(name = "primarySqlSessionTemplate")public SqlSessionTemplate primarySqlSessionTemplate(@Qualifier("primarySqlSessionFactory") SqlSessionFactory sqlSessionFactory) {return new SqlSessionTemplate(sqlSessionFactory);}
}

@Configuration
@MapperScan(basePackages = "com.example.mapper.db2", sqlSessionTemplateRef = "secondarySqlSessionTemplate")
public class SecondaryDataSourceConfig {@Bean(name = "secondaryDataSource")@ConfigurationProperties(prefix = "spring.datasource.secondary")public DataSource secondaryDataSource() {return DataSourceBuilder.create().build();}@Bean(name = "secondarySqlSessionFactory")public SqlSessionFactory secondarySqlSessionFactory(@Qualifier("secondaryDataSource") DataSource dataSource) throws Exception {SqlSessionFactoryBean bean = new SqlSessionFactoryBean();bean.setDataSource(dataSource);return bean.getObject();}@Bean(name = "secondaryTransactionManager")public DataSourceTransactionManager secondaryTransactionManager(@Qualifier("secondaryDataSource") DataSource dataSource) {return new DataSourceTransactionManager(dataSource);}@Bean(name = "secondarySqlSessionTemplate")public SqlSessionTemplate secondarySqlSessionTemplate(@Qualifier("secondarySqlSessionFactory") SqlSessionFactory sqlSessionFactory) {return new SqlSessionTemplate(sqlSessionFactory);}
}

4. 使用多数据源

只需将不同的Mapper接口分别放在com.example.mapper.db1和com.example.mapper.db2包下，Spring Boot会自动注入对应的数据源。

四、常见问题与解决方案

事务管理混乱
每个数据源要有独立的TransactionManager，并用@Transactional(transactionManager = "xxxTransactionManager")指定。
Mapper扫描冲突
@MapperScan要指定basePackages和sqlSessionTemplateRef，避免扫描到错误的数据源。
JPA多数据源
JPA配置类似，但需额外配置EntityManagerFactory和PlatformTransactionManager。