在SpringBoot中连接多个不同的数据库-精创网络云防护

帮助文档
在SpringBoot中连接多个不同的数据库
来源：www.jcwlyf.com更新时间：2025-01-20

在现代应用开发中，Spring Boot因其简洁性和快速开发特性广泛应用于构建企业级应用。Spring Boot通常与关系型数据库结合使用，但在实际项目中，有时需要连接多个不同的数据库（例如，MySQL与PostgreSQL、Oracle与SQL Server等）。那么，如何在Spring Boot中连接多个数据库呢？本文将详细介绍在Spring Boot中配置和使用多个不同的数据库，帮助开发者快速实现这一需求。

一、Spring Boot支持多个数据库连接的原理

Spring Boot通过Spring Data JPA、JDBC等技术来实现数据库连接。默认情况下，Spring Boot应用只会配置一个数据源，但在一些复杂的业务场景中，可能需要同时连接多个不同的数据库。Spring Boot通过配置多个数据源、事务管理、Repository接口等方式来实现这一目标。

要实现多数据源的支持，核心思想是通过配置多个数据源，并通过适当的注解与代码方式来区分每个数据源的作用域。Spring Boot提供了强大的依赖注入机制，可以轻松管理多个数据源的配置。

二、配置多个数据源的步骤

配置多个数据源通常需要以下步骤：

添加相关依赖：首先需要在"pom.xml"中添加与数据库连接相关的依赖。

配置数据源：为每个数据源配置独立的"DataSource"、"EntityManagerFactory"、"TransactionManager"等。

使用注解或标注区分：通过自定义注解来区分不同的数据库连接。

配置JPA或JDBC模板：对于每个数据源，配置相应的JPA或者JDBC模板。

三、Spring Boot多数据源配置示例

以下是一个连接两个不同数据库（MySQL和PostgreSQL）的Spring Boot示例。

1. 在"pom.xml"中添加依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.postgresql</groupId>
        <artifactId>postgresql</artifactId>
        <version>42.2.5</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
</dependencies>

2. 配置两个数据源：

首先，在"application.properties"或"application.yml"中配置两个数据源的连接信息：

# MySQL 数据库配置
spring.datasource.mysql.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.mysql.username=root
spring.datasource.mysql.password=rootpassword
spring.datasource.mysql.driver-class-name=com.mysql.cj.jdbc.Driver

# PostgreSQL 数据库配置
spring.datasource.postgresql.url=jdbc:postgresql://localhost:5432/mydb
spring.datasource.postgresql.username=postgres
spring.datasource.postgresql.password=postgrespassword
spring.datasource.postgresql.driver-class-name=org.postgresql.Driver

3. 配置DataSource，EntityManagerFactory和TransactionManager：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
        basePackages = "com.example.mysql.repository", // MySQL的Repository路径
        entityManagerFactoryRef = "mysqlEntityManagerFactory",
        transactionManagerRef = "mysqlTransactionManager"
)
public class MySQLDataSourceConfig {

    @Primary
    @Bean(name = "mysqlDataSource")
    @ConfigurationProperties(prefix = "spring.datasource.mysql")
    public DataSource dataSource() {
        return DataSourceBuilder.create().build();
    }

    @Primary
    @Bean(name = "mysqlEntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean entityManagerFactory(
            EntityManagerFactoryBuilder builder, 
            @Qualifier("mysqlDataSource") DataSource dataSource) {
        return builder
                .dataSource(dataSource)
                .packages("com.example.mysql.model") // MySQL实体类的包路径
                .persistenceUnit("mysql")
                .build();
    }

    @Primary
    @Bean(name = "mysqlTransactionManager")
    public PlatformTransactionManager transactionManager(
            @Qualifier("mysqlEntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JpaTransactionManager(entityManagerFactory);
    }
}

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
        basePackages = "com.example.postgresql.repository", // PostgreSQL的Repository路径
        entityManagerFactoryRef = "postgresqlEntityManagerFactory",
        transactionManagerRef = "postgresqlTransactionManager"
)
public class PostgreSQLDataSourceConfig {

    @Bean(name = "postgresqlDataSource")
    @ConfigurationProperties(prefix = "spring.datasource.postgresql")
    public DataSource dataSource() {
        return DataSourceBuilder.create().build();
    }

    @Bean(name = "postgresqlEntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean entityManagerFactory(
            EntityManagerFactoryBuilder builder, 
            @Qualifier("postgresqlDataSource") DataSource dataSource) {
        return builder
                .dataSource(dataSource)
                .packages("com.example.postgresql.model") // PostgreSQL实体类的包路径
                .persistenceUnit("postgresql")
                .build();
    }

    @Bean(name = "postgresqlTransactionManager")
    public PlatformTransactionManager transactionManager(
            @Qualifier("postgresqlEntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JpaTransactionManager(entityManagerFactory);
    }
}

四、如何使用多个数据源

在实际应用中，Spring Data JPA允许开发者通过"@Repository"注解与数据源进行绑定。在上面的配置中，我们已经为每个数据库配置了不同的"EntityManagerFactory"和"TransactionManager"。接下来，我们需要在对应的Repository中进行数据源的绑定。

1. 使用"@EnableJpaRepositories"指定数据源的Repository路径。

2. 在服务层或控制层使用自动注入的Repository进行数据库操作。

五、使用JDBC模板连接不同的数据库

如果你需要使用JDBC模板进行数据库操作，可以按照以下步骤配置多个JDBC模板：

@Configuration
public class JdbcConfig {

    @Primary
    @Bean(name = "mysqlJdbcTemplate")
    public JdbcTemplate mysqlJdbcTemplate(@Qualifier("mysqlDataSource") DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }

    @Bean(name = "postgresqlJdbcTemplate")
    public JdbcTemplate postgresqlJdbcTemplate(@Qualifier("postgresqlDataSource") DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

六、使用多数据源时的注意事项

1. 确保不同数据库的配置不冲突：在配置多个数据源时，每个数据源需要独立的配置文件，避免相互影响。

2. 事务管理：确保每个数据源都有独立的事务管理器。如果在一个方法中需要涉及多个数据源操作，考虑使用全局事务管理机制。

3. 性能优化：多个数据源可能会增加数据库连接的负担，因此要合理配置连接池的大小，避免性能瓶颈。

4. 测试和调试：在开发过程中，需要确保每个数据源的配置正确无误，建议通过单元测试验证不同数据库的连接和操作是否正常。

七、总结

在Spring Boot中连接多个不同的数据库并非复杂的任务，只需通过配置多个数据源，并利用Spring的依赖注入机制和JPA/JDBC模板来分别管理每个数据源的连接。通过合理的配置和代码实现，可以灵活地应对多数据库场景。希望本文提供的配置示例能够帮助开发者在项目中顺利实现多数据源连接。