Tomcat运行时找不到H2数据库驱动org.h2.Driver问题求助

结合你描述的场景（用ApiConfig替代web.xml、Linux下Tomcat9部署），我整理了几个核心排查方向和可行方案：

1. 手动触发Liquibase初始化（关键！） #

因为你移除了web.xml，原本靠web.xml配置的Liquibase监听器会失效，需要在JAX-RS的启动类里手动初始化Liquibase：

@ApplicationPath("/rest")
public class ApiConfig extends Application {

    @PostConstruct
    public void initLiquibase() {
        try {
            // 这里的连接参数要和你的H2配置完全匹配
            Connection conn = DriverManager.getConnection("jdbc:h2:/opt/tomcat/webapps/your-app/WEB-INF/db/your-db", "sa", "");
            Database database = DatabaseFactory.getInstance().findCorrectDatabaseImplementation(new JdbcConnection(conn));
            // 确保changelog文件在类路径下（比如放在src/main/resources/db/目录）
            Liquibase liquibase = new Liquibase("db/changelog.xml", new ClassLoaderResourceAccessor(), database);
            liquibase.update(new Contexts(), new LabelExpression());
            conn.close();
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException("Liquibase初始化失败，请检查配置", e);
        }
    }

    // 你的其他配置方法...
    @Override
    public Map<String, Object> getProperties() {
        Map<String, Object> properties = new HashMap<>();
        // 补充你的JAX-RS配置
        return properties;
    }
}

2. 修正H2数据库的连接与权限问题 #

• 路径配置：Linux环境下H2嵌入式模式的路径建议用绝对路径，比如jdbc:h2:/opt/tomcat/webapps/your-app/WEB-INF/db/your-db，避免相对路径导致找不到数据库文件。
• 权限检查：确保Tomcat运行用户对H2数据库文件所在目录（比如WEB-INF/db）有读写权限，否则会出现无法创建/写入数据库的问题。
• 依赖一致性：确认WEB-INF/lib下的H2 jar版本和你项目编译时的版本完全一致，避免版本冲突导致连接失败。

3. 验证JAX-RS的数据源绑定 #

如果你的JAX-RS资源类需要操作数据库，确保数据源配置正确：

// 在ApiConfig中注册数据源相关的提供者或资源
@Override
public Set<Class<?>> getClasses() {
    Set<Class<?>> classes = new HashSet<>();
    classes.add(YourRestResource.class);
    // 如果有自定义数据源提供者也需要添加
    classes.add(DataSourceProvider.class);
    return classes;
}

同时，资源类中建议通过DataSource获取连接，而不是直接用DriverManager，避免连接泄漏：

@Resource(lookup = "java:comp/env/jdbc/YourH2DS")
private DataSource dataSource;

@GET
public String testDb() {
    try (Connection conn = dataSource.getConnection()) {
        // 数据库操作逻辑
        return "数据库连接成功";
    } catch (SQLException e) {
        return "连接失败：" + e.getMessage();
    }
}

4. 日志排查定位具体问题 #

开启详细日志是最快定位问题的方式：

• 在Tomcat的conf/logging.properties中添加：

  org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = FINE
  org.apache.catalina.core.ContainerBase.[Catalina].[localhost].handlers = java.util.logging.ConsoleHandler
  liquibase.level = FINE
  org.h2.level = FINE
  

• 查看Tomcat的logs/catalina.out日志，重点找Liquibase执行的日志、H2连接错误栈，这能帮你精准定位是changelog文件找不到、数据库连接失败还是SQL脚本错误。

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