Pentaho Server 9.4 CE安装后登录失败，JDBC驱动加载异常求助

问题根源 #

你遇到的java.sql.SQLException: Unable to load class: org.hsqldb.jdbcDriver错误，本质是Tomcat无法找到HSQLDB数据库驱动，导致无法连接默认的示例数据库——而Pentaho的登录验证、基础权限数据都存储在这个示例库中，因此出现登录失败。

修复步骤 #

1. 检查并补充HSQLDB驱动 #

• 定位到Pentaho Server安装目录下的tomcat/lib文件夹，确认是否存在hsqldb.jar文件。
• 如果缺失，从安装包的data/hsqldb/lib目录中复制hsqldb.jar到tomcat/lib；若安装包中无此文件，下载与Pentaho 9.4兼容的HSQLDB 2.5.x版本驱动包，提取hsqldb.jar放入该目录。

2. 验证示例数据库配置与文件完整性 #

• 打开pentaho-server/pentaho-solutions/system/applicationContext-spring-security-hibernate.properties文件，检查JDBC配置项是否正确：

  jdbc.driver=org.hsqldb.jdbcDriver
  jdbc.url=jdbc:hsqldb:file:../data/hsqldb/sampledata;shutdown=true
  jdbc.username=sa
  jdbc.password=
  

• 确认pentaho-server/data/hsqldb目录下存在示例数据库文件（sampledata.script、sampledata.data等），若缺失，从完整的Pentaho安装包中复制data/hsqldb目录的全部内容到对应位置。

3. 清理缓存并重启服务 #

• 停止Tomcat服务，删除tomcat/work和tomcat/temp目录下的所有文件。
• 重新启动Tomcat，查看catalina.log是否仍有驱动加载错误，之后尝试登录PUC。

如果上述步骤完成后仍有问题，可以检查Tomcat的类路径配置，确认tomcat/lib目录被正确加载，或者尝试替换全新的HSQLDB驱动包。

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