Spring Boot JPA加载H2驱动失败：Cannot load driver class: org.h2.Driver解决方案

核心原因与修复方案 #

1. 检查H2依赖配置 #

驱动类找不到最常见的原因是依赖缺失或作用域错误：

• 如果pom.xml中H2依赖的scope设为test，主程序运行时无法加载驱动类，需改为runtime或默认的compile
• 确保已正确引入H2依赖，Spring Boot项目推荐使用以下配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

2. 核对application.properties配置 #

确认驱动类名称拼写完全正确，H2的标准驱动类是org.h2.Driver，同时配套完整的数据库配置：

# H2内存库基础配置
spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# JPA适配配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect

# 可选：启用H2控制台用于调试
spring.h2.console.enabled=true

3. 清理依赖缓存并重新构建 #

若依赖下载不完整导致驱动类缺失，执行以下命令刷新依赖：

• Maven：

mvn clean install -U

• Gradle：

./gradlew clean build --refresh-dependencies

4. 验证版本兼容性 #

Spring Boot版本与H2版本需匹配：

• Spring Boot 2.x适配H2 1.4.x或2.x版本
• Spring Boot 3.x需使用H2 2.x及以上版本（适配Java 17+环境）

修复验证 #

重启应用后：

• 若启用H2控制台，访问http://localhost:8080/h2-console，输入配置的JDBC URL、用户名和密码，确认可正常连接
• 查看启动日志，确认无Cannot load driver class报错，JPA初始化流程正常

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