Db2 LUW Java存储过程调用报错SQL4304N求助排查

核心问题定位 #

日志中明确指出类中缺少方法create(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V，这是触发SQL4304N的主要原因，内存不足提示大概率是类加载失败引发的次生问题，优先解决方法匹配与类路径问题。

具体排查步骤 #

1. 修正存储过程的类全限定名 #

你的Java类Db2属于包db2.registry.sql.storedprocedure，但存储过程的EXTERNAL NAME仅写了Db2.create，缺失完整包路径。正确的外部名称需包含全限定类名：

EXTERNAL NAME 'DB2JAR:db2.registry.sql.storedprocedure.Db2.create';

重新创建存储过程：

DROP PROCEDURE RSARKAR.CREATE_USER;
CREATE OR REPLACE PROCEDURE RSARKAR.CREATE_USER
(
  USERID VARCHAR(128),
  PASS   VARCHAR(128) DEFAULT NULL,
  GROUPS VARCHAR(256) DEFAULT NULL
)
LANGUAGE JAVA
SPECIFIC RSARKAR.CREATE_USER
PARAMETER STYLE JAVA
DETERMINISTIC
NO EXTERNAL ACTION
NO SQL
FENCED THREADSAFE
EXTERNAL NAME 'DB2JAR:db2.registry.sql.storedprocedure.Db2.create';
call sqlj.refresh_classes();

2. 验证JAR包中的类与方法签名 #

• 解压DB2.jar，确认目录结构：db2/registry/sql/storedprocedure/Db2.class必须存在。
• 使用javap命令检查方法签名是否完全匹配：

  javap -p -classpath DB2.jar db2.registry.sql.storedprocedure.Db2
  

  输出中必须包含：

  public static void create(java.lang.String, java.lang.String, java.lang.String);
  

  对应的JNI签名就是create(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V，若签名不符（比如参数类型错误、方法非static），会直接触发找不到方法的错误。

3. 检查JAR包的安装与权限 #

• 确认file:/home/rsarkar/plugins/DB2.jar路径存在，且Db2实例用户对该文件有读权限。
• 执行sqlj.remove_jar后，手动删除Db2自动生成的JAR副本：/home/rsarkar/sqllib/function/jar/DB2JAR（若存在），再重新执行sqlj.install_jar和sqlj.refresh_classes。

4. 调整Fenced模式的Java堆大小 #

实例级的JAVA_HEAP_SZ不影响FENCED模式的存储过程，需调整数据库级的FENCED_JAVA_HEAP_SZ参数：

db2 update db cfg for <你的数据库名> using FENCED_JAVA_HEAP_SZ 2048000 -- 单位4KB，对应8GB
db2stop force
db2start

该参数控制FENCED进程的JVM堆大小，避免类加载时因内存不足失败。

5. 确认依赖包是否齐全 #

你的Db2.java依赖了org.apache.commons.lang3.StringUtils和自定义的db2.registry.User等类：

• 这些依赖类必须包含在DB2.jar中，或通过sqlj.install_jar单独安装到Db2中并关联。
• 解压DB2.jar，检查是否包含org/apache/commons/lang3/StringUtils.class和db2/registry/User.class等文件，缺失则需重新打包JAR。

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