Spring Boot多数据源配置详解

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

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

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

二、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会自动注入对应的数据源。

四、常见问题与解决方案

1. 事务管理混乱
   每个数据源要有独立的TransactionManager，并用@Transactional(transactionManager = "xxxTransactionManager")指定。

2. Mapper扫描冲突
   @MapperScan要指定basePackages和sqlSessionTemplateRef，避免扫描到错误的数据源。

3. JPA多数据源
   JPA配置类似，但需额外配置EntityManagerFactory和PlatformTransactionManager。

五、最佳实践

• 命名规范：Bean、包名、配置前缀要清晰区分。
• 配置解耦：推荐用@ConfigurationProperties集中管理数据源配置。
• 动态数据源：如需动态切换，可用AbstractRoutingDataSource或开源组件（如druid、dynamic-datasource）。
• 安全性：敏感信息建议用加密或环境变量管理。

六、总结

Spring Boot多数据源配置并不复杂，关键在于理解原理、规范配置、合理分包。掌握多数据源技术，不仅能提升系统扩展性和灵活性，也是后端开发进阶的必备技能。

---

如果你觉得本文有帮助，欢迎点赞、关注、转发！如有疑问，欢迎留言交流。

---

如需Word版或代码示例工程，请留言获取！