启动H2控制台报错找不到主类org.h2.tools.Console该如何解决

报错根因 #

你遇到的java.lang.ClassNotFoundException: org.h2.tools.Console报错，核心原因是命令中-cp jar的类路径配置错误，没有引入包含H2工具类的jar包。

解决步骤 #

• 第一步：定位H2驱动jar包路径
  已完成Keycloak源码编译的场景下，H2依赖包默认存放在bin目录同级的lib目录下，在当前bin目录执行以下命令即可获取完整路径：
  find ../lib -name "h2-*.jar"
  命令返回结果示例：../lib/io/h2/h2/2.2.224/h2-2.2.224.jar

• 第二步：修正启动命令
  将原命令中的类路径参数替换为上一步查询到的H2 jar包路径，修正后的命令示例：
  java -cp ../lib/io/h2/h2/2.2.224/h2-2.2.224.jar org.h2.tools.Console -url "$url" -user sa -password ""

简化方案 #

如果不想单独查找H2 jar包路径，也可以直接引入lib目录下所有jar包，命令如下：
java -cp "../lib/*" org.h2.tools.Console -url "$url" -user sa -password ""

执行修正后的命令即可正常启动H2控制台，默认访问地址为http://localhost:8082，填入对应连接参数即可访问Keycloak的H2数据库。

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