报错“Failed to determine a suitable driver class”的解决方法咨询

错误详情 #

Reason: Failed to determine a suitable driver class
Action:
Consider the following:If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).

解决方案 #

1. 使用嵌入式数据库（H2、HSQL或Derby）场景

• 在项目依赖管理文件中添加对应数据库的runtime依赖：
  • Maven（pom.xml）示例（以H2为例）：

    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
    

  • Gradle（build.gradle）示例（以H2为例）：

    runtimeOnly 'com.h2database:h2'
    

• 执行依赖同步操作（Maven的mvn clean install或Gradle的gradle build），确保驱动包被加载到类路径。

2. 依赖特定环境配置文件的外部数据库场景

• 激活目标配置文件：
  • 启动项目时添加VM参数：-Dspring.profiles.active=你的环境标识（如dev、prod）
  • 或在主配置文件中指定：

    # application.properties
    spring.profiles.active=dev
    

    # application.yml
    spring:
      profiles:
        active: dev
    

• 确认环境配置文件的数据库参数：
  在对应环境的配置文件（如application-dev.properties）中，确保数据库配置完整且正确：

  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  spring.datasource.url=jdbc:mysql://localhost:3306/your_database
  spring.datasource.username=db_user
  spring.datasource.password=db_password
  

额外排查项

• 若已添加外部数据库依赖，检查依赖坐标是否正确、版本与Spring Boot版本是否兼容
• 核对配置文件中spring.datasource.driver-class-name的拼写，确保与驱动类全路径一致

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