Spring Boot 2.0.0多数据源配置问题：Oracle与H2连接失败

问题背景 #

你提到在Spring Boot升级到2.0.0版本前，远程Oracle + 本地H2的双数据源配置一切正常，但升级后配置完全失效。这几乎肯定是Spring Boot 2.x在数据源自动配置逻辑、属性绑定规则上的变更导致的——1.x版本的多数据源配置方式在2.x中不再兼容。

核心变更要点（1.x vs 2.x） #

• Spring Boot 2.x 对spring.datasource.*的自动配置做了严格限制，默认只会自动初始化一个主数据源
• 属性绑定逻辑更严谨，多数据源必须显式指定独立的配置前缀，不能再混用默认的spring.datasource
• 数据源初始化、事务管理器的注册方式也有细微调整，需要手动明确区分

分步修复方案 #

1. 修正Application Properties配置 #

为两个数据源配置独立的前缀，避免与默认数据源配置冲突：

# 主数据源：远程Oracle
spring.datasource.oracle.url=jdbc:oracle:thin:@//your-oracle-host:1521/your-db-sid
spring.datasource.oracle.username=your-oracle-username
spring.datasource.oracle.password=your-oracle-password
spring.datasource.oracle.driver-class-name=oracle.jdbc.OracleDriver

# 次数据源：本地H2文件库
spring.datasource.h2.url=jdbc:h2:file:./local-h2-db
spring.datasource.h2.username=sa
spring.datasource.h2.password=
spring.datasource.h2.driver-class-name=org.h2.Driver

2. 手动配置数据源Bean #

显式创建两个数据源的Bean，标记主数据源（@Primary），并通过@ConfigurationProperties绑定对应前缀的配置：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Primary;

import javax.sql.DataSource;

@Configuration
public class MultiDataSourceConfig {

    // Oracle主数据源
    @Primary
    @Bean(name = "oracleDataSource")
    @ConfigurationProperties(prefix = "spring.datasource.oracle")
    public DataSource oracleDataSource() {
        return DataSourceBuilder.create().build();
    }

    // H2次数据源
    @Bean(name = "h2DataSource")
    @ConfigurationProperties(prefix = "spring.datasource.h2")
    public DataSource h2DataSource() {
        return DataSourceBuilder.create().build();
    }
}

3. 适配数据访问层（JdbcTemplate/JPA） #

如果你用JdbcTemplate：

为每个数据源创建对应的JdbcTemplate Bean，确保操作时能精准绑定：

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

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

如果你用JPA（Spring Data JPA）：

需要为两个数据源分别配置EntityManagerFactory和TransactionManager，同时指定各自的实体类、Repository包路径：

// Oracle JPA配置类
@Configuration
@EnableJpaRepositories(
        basePackages = "com.your-project.oracle.repos", // Oracle Repository所在包
        entityManagerFactoryRef = "oracleEntityManagerFactory",
        transactionManagerRef = "oracleTransactionManager"
)
public class OracleJpaConfig {

    @Autowired
    @Qualifier("oracleDataSource")
    private DataSource oracleDataSource;

    @Primary
    @Bean(name = "oracleEntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean oracleEntityManagerFactory(EntityManagerFactoryBuilder builder) {
        return builder
                .dataSource(oracleDataSource)
                .packages("com.your-project.oracle.models") // Oracle实体类所在包
                .persistenceUnit("oraclePU")
                .build();
    }

    @Primary
    @Bean(name = "oracleTransactionManager")
    public PlatformTransactionManager oracleTransactionManager(
            @Qualifier("oracleEntityManagerFactory") LocalContainerEntityManagerFactoryBean emFactory) {
        return new JpaTransactionManager(emFactory.getObject());
    }
}

// H2 JPA配置类
@Configuration
@EnableJpaRepositories(
        basePackages = "com.your-project.h2.repos", // H2 Repository所在包
        entityManagerFactoryRef = "h2EntityManagerFactory",
        transactionManagerRef = "h2TransactionManager"
)
public class H2JpaConfig {

    @Autowired
    @Qualifier("h2DataSource")
    private DataSource h2DataSource;

    @Bean(name = "h2EntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean h2EntityManagerFactory(EntityManagerFactoryBuilder builder) {
        return builder
                .dataSource(h2DataSource)
                .packages("com.your-project.h2.models") // H2实体类所在包
                .persistenceUnit("h2PU")
                .build();
    }

    @Bean(name = "h2TransactionManager")
    public PlatformTransactionManager h2TransactionManager(
            @Qualifier("h2EntityManagerFactory") LocalContainerEntityManagerFactoryBean emFactory) {
        return new JpaTransactionManager(emFactory.getObject());
    }
}

4. 修正Controller/Service中的数据源引用 #

在注入Repository或JdbcTemplate时，使用@Qualifier明确指定对应的Bean名称（如果依赖注入出现歧义的话）：

@RestController
@RequestMapping("/cards")
public class CardController {

    private final OracleCardRepository oracleCardRepo;
    private final H2CardRepository h2CardRepo;

    // 推荐构造函数注入，避免歧义
    public CardController(OracleCardRepository oracleCardRepo, H2CardRepository h2CardRepo) {
        this.oracleCardRepo = oracleCardRepo;
        this.h2CardRepo = h2CardRepo;
    }

    @PutMapping("/{id}")
    public ResponseEntity<Card> updateCard(@PathVariable Long id, @RequestBody Card card) {
        // 操作Oracle数据源
        Card updatedCard = oracleCardRepo.save(card);
        // 同步到H2数据源（按需）
        h2CardRepo.save(convertToLocalCard(updatedCard));
        return ResponseEntity.ok(updatedCard);
    }
}

常见报错排查 #

如果还是有问题，优先检查以下几点：

• 确认spring-boot-starter-jdbc或spring-boot-starter-data-jpa依赖已正确引入
• Oracle驱动版本是否适配Spring Boot 2.0（推荐用com.oracle.database.jdbc:ojdbc8）
• 实体类包路径是否和JPA配置中的packages参数完全匹配
• 是否存在多个@Primary标记的Bean，导致容器初始化冲突

内容的提问来源于stack exchange，提问作者Michael Motúz