Spring Boot多数据源配置报错：jdbcUrl与driverClassName必填异常

这个异常本质是Spring无法正确读取到数据源的JDBC连接地址，大概率是配置key不匹配或者双数据源的配置逻辑混乱导致的，我帮你一步步梳理解决：

1. 先修正配置文件的写法（核心！） #

首先要给H2和Postgres分别配置独立的前缀，避免和默认数据源的spring.datasource冲突，同时注意Spring Boot 2.x+对第三方数据源的配置要求：

application.properties 示例： #

# H2 数据源配置
spring.h2.datasource.jdbc-url=jdbc:h2:mem:testdb
spring.h2.datasource.driver-class-name=org.h2.Driver
spring.h2.datasource.username=sa
spring.h2.datasource.password=

# Postgres 数据源配置
spring.postgres.datasource.jdbc-url=jdbc:postgresql://localhost:5432/your_db_name
spring.postgres.datasource.driver-class-name=org.postgresql.Driver
spring.postgres.datasource.username=postgres
spring.postgres.datasource.password=your_pwd

# H2 JPA 配置
spring.h2.jpa.hibernate.ddl-auto=update
spring.h2.jpa.hibernate.dialect=org.hibernate.dialect.H2Dialect

# Postgres JPA 配置
spring.postgres.jpa.hibernate.ddl-auto=update
spring.postgres.jpa.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

重点：PostgreSQL必须用jdbc-url而不是url，因为Spring Boot 2.x之后，url会被DataSourceBuilder识别为通用URL参数，而非JDBC连接地址，这是触发jdbcUrl is required异常的常见原因。H2用jdbc-url也完全兼容，统一写法更稳妥。

2. 重构H2数据源配置类 #

你原来的配置类里存在命名混淆（方法名是postgresDataSource但实际是H2配置），而且前缀用了默认的spring.datasource，这会导致和Postgres数据源冲突，重新整理后的H2配置类如下：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
        entityManagerFactoryRef = "h2EntityManagerFactory",
        transactionManagerRef = "h2TransactionManager",
        basePackages = {"uz.tarv.ahmad.entities.h2"} // 对应H2实体类的包路径
)
public class H2Config {

    @Autowired
    private Environment env;

    // 标记为主数据源，解决多数据源的注入歧义
    @Primary
    @Bean(name = "h2DataSource")
    @ConfigurationProperties(prefix = "spring.h2.datasource") // 和配置文件的前缀完全对应
    public DataSource h2DataSource() {
        return DataSourceBuilder.create().build();
    }

    @Primary
    @Bean(name = "h2EntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean h2EntityManagerFactory(
            EntityManagerFactoryBuilder builder,
            @Qualifier("h2DataSource") DataSource dataSource) {
        return builder
                .dataSource(dataSource)
                .packages("uz.tarv.ahmad.entities.h2")
                .persistenceUnit("h2PU") // 独立的持久化单元
                .properties(jpaProperties())
                .build();
    }

    @Primary
    @Bean(name = "h2TransactionManager")
    public PlatformTransactionManager h2TransactionManager(
            @Qualifier("h2EntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JpaTransactionManager(entityManagerFactory);
    }

    // 读取H2对应的JPA配置
    private Map<String, Object> jpaProperties() {
        Map<String, Object> props = new HashMap<>();
        props.put("hibernate.hbm2ddl.auto", env.getProperty("spring.h2.jpa.hibernate.ddl-auto"));
        props.put("hibernate.dialect", env.getProperty("spring.h2.jpa.hibernate.dialect"));
        return props;
    }
}

3. 补充Postgres数据源配置类 #

你还需要单独写Postgres的配置类，和H2配置类区分开：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
        entityManagerFactoryRef = "postgresEntityManagerFactory",
        transactionManagerRef = "postgresTransactionManager",
        basePackages = {"uz.tarv.ahmad.entities.postgres"} // 对应Postgres实体类的包路径
)
public class PostgresConfig {

    @Autowired
    private Environment env;

    @Bean(name = "postgresDataSource")
    @ConfigurationProperties(prefix = "spring.postgres.datasource") // 和配置文件前缀对应
    public DataSource postgresDataSource() {
        return DataSourceBuilder.create().build();
    }

    @Bean(name = "postgresEntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean postgresEntityManagerFactory(
            EntityManagerFactoryBuilder builder,
            @Qualifier("postgresDataSource") DataSource dataSource) {
        return builder
                .dataSource(dataSource)
                .packages("uz.tarv.ahmad.entities.postgres")
                .persistenceUnit("postgresPU")
                .properties(jpaProperties())
                .build();
    }

    @Bean(name = "postgresTransactionManager")
    public PlatformTransactionManager postgresTransactionManager(
            @Qualifier("postgresEntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JpaTransactionManager(entityManagerFactory);
    }

    private Map<String, Object> jpaProperties() {
        Map<String, Object> props = new HashMap<>();
        props.put("hibernate.hbm2ddl.auto", env.getProperty("spring.postgres.jpa.hibernate.ddl-auto"));
        props.put("hibernate.dialect", env.getProperty("spring.postgres.jpa.hibernate.dialect"));
        return props;
    }
}

4. 最后检查几个关键细节 #

• 确保实体类和Repository接口的包路径，和配置类中@EnableJpaRepositories的basePackages完全匹配；
• 必须给其中一个数据源（这里是H2）加上@Primary注解，否则Spring注入时会出现歧义；
• 启动前确认Postgres服务已启动，且配置的数据库名称已经存在（如果用ddl-auto=update的话需要提前创建库，create-drop会自动创建）。

内容的提问来源于stack exchange，提问作者valijon