Spring Boot多数据源配置详解

发布于:2025-07-10 ⋅ 阅读:(22) ⋅ 点赞:(0)

Spring Boot多数据源配置详解

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

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

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

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

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

三、实战: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.db1com.example.mapper.db2包下,Spring Boot会自动注入对应的数据源。

四、常见问题与解决方案

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

  2. Mapper扫描冲突
    @MapperScan要指定basePackagessqlSessionTemplateRef,避免扫描到错误的数据源。

  3. JPA多数据源
    JPA配置类似,但需额外配置EntityManagerFactoryPlatformTransactionManager

五、最佳实践

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

六、总结

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


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


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


网站公告

今日签到

点亮在社区的每一天
去签到