HSQLDB创建自定义函数提示找不到实现类的问题排查

我想在嵌入式HSQLDB上使用SymmetricDS，SymmetricDS需要创建一些管理表和函数，可通过symadmin执行对应SQL。其中创建函数的SQL如下：

CREATE FUNCTION sym_base_64_encode(binaryData BINARY)
RETURNS VARCHAR(1000000) 
NO SQL
LANGUAGE JAVA PARAMETER STYLE JAVA
EXTERNAL NAME 'CLASSPATH:org.jumpmind.symmetric.db.hsqldb.HsqlDbFunctions.encodeBase64';

执行后出现错误：

[Code: -5501, SQL State: 42501]  user lacks privilege or object not found: org.jumpmind.symmetric.db.hsqldb.HsqlDbFunctions

我已添加依赖并通过代码测试确认JVM可访问该类：

public class Application {
    public static void main(String[] args) {
        System.out.println("HsqlDbFunctions.encodeBase64: " + org.jumpmind.symmetric.db.hsqldb.HsqlDbFunctions.encodeBase64("test".getBytes()));
        ...
    }
}

输出结果：

HsqlDbFunctions.encodeBase64: dGVzdA==

这是一个简单的SpringBoot应用，无特殊类加载机制，运行HSQLDB的JVM确实能访问该类。通过数据库工具直接执行SQL也会出现相同错误。

我在自定义类中编写静态方法后尝试创建函数，同样出现问题：

package nl.softworks.calendarAggregator;

import org.hsqldb.persist.HsqlProperties;

public class Application {
    public static void main(String[] args) {
        System.out.println("HsqlDbFunctions.encodeBase64: " + org.jumpmind.symmetric.db.hsqldb.HsqlDbFunctions.encodeBase64("test".getBytes()));

        HsqlProperties hsqlProperties = new HsqlProperties();
        hsqlProperties.setProperty("server.port", 9147);
        hsqlProperties.setProperty("hsqldb.tx", "mvcc"); // 多版本并发控制
        hsqlProperties.setProperty("server.database.0", "file:hsqldb/calendarAggregator;user=technical;password=technical;shutdown=true");
        hsqlProperties.setProperty("server.dbname.0", "calendarAggregator");

        org.hsqldb.Server server = new org.hsqldb.Server();
        try {
            server.setProperties(hsqlProperties);
        } catch (Exception e) {
            e.printStackTrace();
        }
        server.start();
    }

    public static String hello() {
        return "Hello from Application!";
    }
}

对应的创建函数SQL：

CREATE FUNCTION HELLO()
RETURNS VARCHAR(200)
LANGUAGE JAVA
DETERMINISTIC
NO SQL
EXTERNAL NAME 'CLASSPATH:nl.softworks.calendarAggregator.Application.hello';         

错误信息：

[Code: -5501, SQL State: 42501]  user lacks privilege or object not found: nl.softworks.calendarAggregator.Application

请问该错误的原因是什么？

这个错误的核心原因是HSQLDB服务器的类加载器无法访问目标Java类，尽管你的应用JVM能找到这些类，但HSQLDB自身的类加载器和应用的类加载器相互独立，具体原因和解决办法如下：

核心原因 #

1. 类加载器隔离：通过代码启动HSQLDB Server时，HSQLDB使用独立的类加载器加载类，默认不会包含你的应用类路径或SymmetricDS的依赖包，导致找不到指定类。
2. 权限缺失：错误提示中的"user lacks privilege"说明当前数据库用户可能没有创建函数或访问外部Java类的权限。

解决步骤 #

1. 确保HSQLDB能访问目标类的类路径

   • Spring Boot可执行JAR使用自定义类加载器，HSQLDB可能无法加载内部类。可将应用打包为普通JAR，或者将SymmetricDS的依赖JAR单独放在HSQLDB能访问的目录中，启动时通过-cp参数指定完整类路径。
   • 在代码中添加类路径打印，确认HSQLDB进程能访问目标类：

     System.out.println("当前类路径：" + System.getProperty("java.class.path"));
     

     检查输出是否包含SymmetricDS的JAR和你的应用类所在路径。

2. 调整函数创建语句的类路径前缀

   • 尝试去掉CLASSPATH:前缀，直接使用类的全限定名加方法名，例如：

     EXTERNAL NAME 'org.jumpmind.symmetric.db.hsqldb.HsqlDbFunctions.encodeBase64'
     

     部分场景下，HSQLDB会使用应用的类加载器查找类，无需指定前缀。

3. 授予数据库用户必要权限

   • 执行SQL为用户授予创建函数和执行函数的权限：

     GRANT CREATE FUNCTION TO technical;
     GRANT EXECUTE ON FUNCTION sym_base_64_encode TO technical;
     

     （technical为你的数据库用户名，根据实际情况替换）

4. Spring Boot特殊处理

   • 如果使用Spring Boot，可通过org.springframework.boot.loader.PropertiesLauncher启动应用，确保类路径能被HSQLDB正确识别；或者将HSQLDB配置为嵌入式模式而非服务器模式，共享应用的类加载器。

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