Tomcat服务器运行WAR文件报错：无法获取JDBC驱动实例

看起来你遇到的是H2数据库驱动未正确加载导致的Tomcat启动失败问题，我帮你梳理几个关键的排查和解决步骤：

• 检查H2驱动依赖的打包情况
  如果你的项目用Maven或Gradle构建，首先要确保H2驱动依赖的scope设置正确，并且被打包到WAR文件的WEB-INF/lib目录中：

  • Maven项目的pom.xml依赖示例：

    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>2.2.224</version> <!-- 使用你项目对应的版本 -->
        <scope>compile</scope> <!-- 不要设为provided，否则不会打包到WAR -->
    </dependency>
    

  • Gradle项目的build.gradle依赖示例：

    implementation 'com.h2database:h2:2.2.224'
    

  构建WAR后，解压检查WEB-INF/lib目录下是否有h2-x.x.x.jar文件，这是Tomcat能加载驱动的前提。

• 确认JDBC URL的兼容性设置
  你的内存数据库URL jdbc:h2:mem:database格式是正确的，但H2内存数据库默认会在最后一个连接关闭时销毁数据库，这可能导致启动时无法获取实例。建议添加DB_CLOSE_DELAY=-1参数：

  jdbc:h2:mem:database;DB_CLOSE_DELAY=-1
  

• 验证数据源配置的驱动类名
  不管你是用框架自动配置还是手动编写数据源，都要确保驱动类名指定正确：

  • 比如Spring Boot的application.properties配置：

    spring.datasource.driver-class-name=org.h2.Driver
    spring.datasource.url=jdbc:h2:mem:database;DB_CLOSE_DELAY=-1
    spring.datasource.username=sa
    spring.datasource.password=
    

  手动配置DataSource时，也要明确设置driverClassName为org.h2.Driver。

• 排查类加载冲突问题
  如果你的Tomcat全局lib目录中存在其他版本的H2驱动，可能会和WAR包内的驱动发生冲突。建议删除Tomcat全局lib中的H2驱动，保持依赖只存在于WAR包内，避免版本不一致导致的加载失败。

如果以上步骤都无法解决问题，可以查看日志中的完整栈跟踪信息，确认是否存在其他依赖缺失或类加载异常的情况。

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