Spring Boot多数据源配置详解-EW帮帮网

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/db1
      username: root
      password: 123456
      driver-class-name: com.mysql.cj.jdbc.Driver
    secondary:
      url: jdbc:mysql://localhost:3306/db2
      username: root
      password: 123456
      driver-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。

五、最佳实践

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

六、总结

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

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

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

Spring Boot多数据源配置详解