Spring Boot 2.0迁移报错：jdbcUrl与driverClassName必填问题及解决

问题根源解析 #

这问题我升级Spring Boot 2.0的时候也踩过坑，核心原因是Spring Boot 1.5.x和2.0.x在数据源自动配置和默认数据源实现上的差异，咱们一步步拆解：

1. 默认数据源变更与配置参数要求差异 #

Spring Boot 2.0开始把HikariCP作为默认的数据源实现，而1.5.x版本默认用的是Tomcat JDBC Pool（或者你手动指定的其他数据源）。不同数据源对连接配置的参数要求不一样：

• 旧版数据源（比如Tomcat JDBC）接受url作为连接地址参数；
• 但HikariCP要求必须用jdbcUrl作为连接地址参数，它不会自动识别url属性。

你的DatabaseConfig.java里自定义的dataSource()方法，大概率是按照1.5.x的逻辑配置的——直接读取spring.datasource.url并设置给数据源的url属性，这就导致HikariCP初始化时找不到它需要的jdbcUrl，从而抛出jdbcUrl is required with driverClassName的错误。

2. 为什么删除自定义dataSource()方法就解决了问题？ #

Spring Boot 2.0的自动配置已经做了完全适配：当没有自定义数据源Bean时，自动配置会读取你配置的spring.datasource.*属性（包括url），然后自动转换为HikariCP需要的jdbcUrl参数，帮你完成数据源的正确初始化。

你的自定义dataSource()方法相当于覆盖了自动配置的逻辑，而且没有跟上2.0版本对HikariCP的配置要求，所以删掉它之后，自动配置就能正常接管数据源的创建工作了。

3. 如果想保留自定义数据源该怎么改？ #

要是你确实需要自定义数据源逻辑，不用删掉整个方法，只要调整配置方式适配HikariCP就行：

• 方式一：直接指定jdbcUrl参数

  @Bean
  public DataSource dataSource(@Value("${spring.datasource.url}") String jdbcUrl,
                               @Value("${spring.datasource.username}") String username,
                               @Value("${spring.datasource.password}") String password,
                               @Value("${spring.datasource.driver-class-name}") String driverClassName) {
      HikariDataSource dataSource = new HikariDataSource();
      dataSource.setJdbcUrl(jdbcUrl);
      dataSource.setUsername(username);
      dataSource.setPassword(password);
      dataSource.setDriverClassName(driverClassName);
      // 可添加其他自定义连接池配置
      return dataSource;
  }
  

• 方式二：借助DataSourceProperties自动绑定（更优雅）
  这种方式会自动处理属性映射（把spring.datasource.url转成HikariCP需要的jdbcUrl）：

  @Bean
  public DataSource dataSource(DataSourceProperties properties) {
      return properties.initializeDataSourceBuilder()
              // 这里可添加自定义连接池参数
              .build();
  }
  

内容的提问来源于stack exchange，提问作者Batuhan Kök