本文详解 Spring Boot 应用启动时出现 “Failed to load driver class org.h2.Driver” 错误的根本原因与修复方法，重点说明为何仅引入 spring-boot-starter-jdbc 或 spring-boot-starter-data-jpa 不足以自动提供 H2 驱动，以及如何正确配置依赖、属性和版本兼容性。
本文详解 spring boot 应用启动时出现 “failed to load driver class org.h2.driver” 错误的根本原因与修复方法，重点说明为何仅引入 `spring-boot-starter-jdbc` 或 `spring-boot-starter-data-jpa` 不足以自动提供 h2 驱动，以及如何正确配置依赖、属性和版本兼容性。
该错误（Failed to load driver class org.h2.Driver from HikariConfig class classloader）是 Spring Boot 3.x 项目中使用 H2 内存数据库时的典型问题，其本质并非配置错误，而是H2 JDBC 驱动未被正确引入到运行时类路径（runtime classpath）。尽管 spring-boot-starter-data-jpa 和 spring-boot-starter-jdbc 提供了数据访问抽象层，但它们不传递性地包含任何具体数据库驱动——H2、PostgreSQL 或 MySQL 的驱动必须显式声明。
✅ 正确添加 H2 驱动依赖
在 pom.xml 的
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>⚠️ 注意：
runtime 是推荐写法（也是 Spring Boot 官方文档建议），它表示该依赖仅在运行时和测试时需要，不参与编译；若省略 scope，默认为 compile，虽可工作但不符合语义最佳实践。
? 补充：检查并清理冗余/冲突依赖
您当前的 pom.xml 中存在若干需调整项，可能引发隐性兼容性问题：
- ❌ 移除手动引入的 javax.persistence-api（Spring Boot 3+ 已全面迁移至 Jakarta EE 9+ 命名空间，应使用 jakarta.persistence:jakarta.persistence-api）；
- ❌ 移除手动引入的 hibernate-core（spring-boot-starter-data-jpa 已管理其兼容版本，显式声明易导致版本冲突）；
- ❌ jackson-databind 的 2.12.3 版本较旧，且与 Spring Boot 3.0.3（基于 Jackson 2.14+）不兼容，建议删除，由 Starter 自动拉取；
修正后的关键依赖片段如下：
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- ✅ 必须添加：H2 运行时驱动 -->
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>
<!-- ✅ 启用 H2 控制台（开发调试用） -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<!-- 其他依赖（如 validation、test）保持不变 -->
</dependencies>?️ application.properties 配置验证（无需修改）
您当前的配置已符合 Spring Boot 3.x 规范，可保留：
# 使用内存模式 H2 数据库 spring.datasource.url=jdbc:h2:mem:testdb # 启用 H2 Console（访问 http://localhost:8080/h2-console） spring.h2.console.enabled=true # JPA DDL 策略（开发环境适用） spring.jpa.hibernate.ddl-auto=create-drop spring.jpa.show-sql=true # 可选：格式化 SQL 输出（提升可读性） spring.jpa.properties.hibernate.format_sql=true
? 提示：Spring Boot 3.x 默认启用 Jakarta EE 命名空间，因此 @Entity 等注解应来自 jakarta.persistence.*（而非 javax.persistence.*）。请确认 Player.java 中的导入是否已更新：
import jakarta.persistence.Entity; import jakarta.persistence.GeneratedValue; import jakarta.persistence.GenerationType; import jakarta.persistence.Id;
✅ 验证与启动
完成上述修改后：
- 执行 mvn clean compile 清理并重新编译；
- 检查 Maven 依赖树，确认 com.h2database:h2 出现在 runtime 范围：
mvn dependency:tree | findstr "h2" # 应看到类似：[INFO] \- com.h2database:h2:jar:2.2.224:runtime
- 启动应用，控制台将不再报 Failed to load driver class，且可正常访问 http://localhost:8080/h2-console 并连接 jdbc:h2:mem:testdb。
? 总结要点
- 根本原因：H2 驱动缺失 → HikariCP 无法加载 org.h2.Driver 类；
- 唯一必要操作：显式添加 com.h2database:h2 依赖，scope=runtime；
- 避免陷阱：不要手动引入 JPA/Hibernate 实现类库（如 hibernate-core），交由 Spring Boot Starter 统一管理；
- 兼容性前提：Spring Boot 3.x + Java 17+ 要求所有依赖遵循 Jakarta EE 9+（jakarta.* 包名），旧 javax.* 注解将导致启动失败；
- 生产提示：H2 仅适用于开发/测试；生产环境务必切换为 PostgreSQL、MySQL 等持久化数据库，并替换对应驱动依赖。
遵循以上步骤，即可彻底解决 H2 驱动加载失败问题，确保数据源初始化顺利进行。
