SpringBoot(JHipster)启动报错：spring.datasource.type绑定失败

问题核心 #

启动时出现错误：无法将spring.datasource.type的属性值com.mysql.jdbc.Driver绑定到java.lang.Class<javax.sql.DataSource>，原因是java.lang.ClassNotFoundException: com.mysql.jdbc.Driver。但你提供的application-dev.yml中spring.datasource.type配置的是com.zaxxer.hikari.HikariDataSource，说明实际生效的配置被覆盖，或依赖缺失。

排查步骤 #

• 检查所有配置文件：除application-dev.yml外，查看根目录的application.yml、其他环境（如prod）的配置文件，确认是否有spring.datasource.type被设为com.mysql.jdbc.Driver，不同配置文件的优先级可能导致当前配置被覆盖。
• 确认启动环境：启动应用时必须指定--spring.profiles.active=dev参数，否则Spring Boot会默认加载application.yml的配置，而非dev环境的配置。
• 修复MySQL驱动依赖：com.mysql.jdbc.Driver属于旧版MySQL驱动（mysql-connector-java），新版驱动（mysql-connector-j）已改为com.mysql.cj.jdbc.Driver。确保pom.xml中引入正确的驱动依赖：
  旧版驱动（适配Spring Boot 2.3及以下）：

  <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <scope>runtime</scope>
  </dependency>
  

  新版驱动（Spring Boot 2.4+推荐）：

  <dependency>
      <groupId>com.mysql</groupId>
      <artifactId>mysql-connector-j</artifactId>
      <scope>runtime</scope>
  </dependency>
  

  注意：spring-boot-starter-data-jdbc不包含MySQL驱动，需单独引入。
• 排查配置覆盖来源：检查是否存在环境变量（如SPRING_DATASOURCE_TYPE）、系统属性、命令行参数设置了spring.datasource.type=com.mysql.jdbc.Driver，这些配置的优先级高于配置文件。
• 检查JHipster自定义配置：查看项目中的DatabaseConfiguration.java等配置类，确认是否有硬编码设置数据源类型，或通过@ConfigurationProperties注解引入的配置冲突。
• 清理缓存重新构建：执行mvn clean install清理Maven缓存，重新构建项目后再尝试启动，避免依赖缓存问题导致的类加载失败。

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