Spring Boot 2.0多数据源配置报错：是否需统一属性命名格式？

核心结论 #

Spring Boot 2.0中不需要强制统一整个yml文件的属性命名格式，但必须保证单个数据源的配置属性与你使用的数据源配置类（尤其是HikariCP的映射规则）匹配，否则会出现参数无法识别的报错。

报错原因分析 #

你遇到的IllegalArgumentException: dataSource or dataSourceClassName or jdbcUrl is required，本质是某一个数据源的配置参数没有被正确映射到HikariCP的属性上：

• HikariCP原生配置属性为驼峰格式（如jdbcUrl、driverClassName），这是它的setter方法直接对应的参数名。
• Spring Boot支持配置属性的松散匹配，所以driver-class-name可以自动映射到driverClassName；但在多数据源自定义绑定场景下，url不会被自动转换为Hikari需要的jdbcUrl，必须显式指定。

正确配置方案 #

针对多数据源场景，推荐两种可靠的配置方式：

方式1：统一使用Hikari原生驼峰命名 #

直接采用Hikari原生的属性名，避免绑定歧义，配置类可直接通过@ConfigurationProperties绑定：

dataSource-1:
  driverClassName: oracle.jdbc.OracleDriver
  jdbcUrl: jdbc:oracle:thin:@xxx:1521/xxx

dataSource-2:
  driverClassName: org.postgresql.Driver
  jdbcUrl: jdbc:postgresql://xxx:5432/xxx

方式2：使用Spring Boot短横线命名，确保参数对应 #

如果习惯短横线命名，需注意将连接地址属性改为jdbc-url（而非url），保证能映射到Hikari的jdbcUrl：

datasource-2:
  driver-class-name: org.postgresql.Driver
  jdbc-url: jdbc:postgresql://xxx:5432/xxx

关键注意事项 #

• 多数据源场景下禁止混用url和jdbc-url：url仅在Spring Boot默认单数据源场景下会被自动转换，自定义多数据源绑定时必须用jdbc-url。
• 单个数据源内的属性风格要统一，不要同时出现driverClassName和driver-class-name，避免配置混乱。

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