DB2 UDB Java 存儲過程常見錯誤碼深度解析與排錯實戰（下）

前言

在開發與部署 DB2 UDB Java 存儲過程時，開發人員經常會遇到各種錯誤碼。本文承接上篇，繼續深入剖析 SQL4304、SQL4306、SQL20200、SQL20201、SQL20204、SQL0449、SQL0444、SQL0440、SQL1042、SQL1131 等常見錯誤的成因、診斷方法與具體修正步驟，並提供完整的代碼示例與日誌分析技巧，助您快速定位並解決問題。

SQL4304：Java 類加載失敗

SQL4304 RC=1 —— 類名或方法名拼寫錯誤

當 CREATE PROCEDURE 語句中 EXTERNAL NAME 子句指定的類名或方法名與實際編譯的 .class 文件不匹配時，會拋出 SQL4304N reason code "1"。

典型錯誤示例： EXTERNAL NAME 'SQL4304RC1!abend' 中類名應為 SQL4304RC1，若寫成 SQL4304RC1（缺少 'L'）即會報錯。

修正步驟：

1. 刪除現有存儲過程：DROP PROCEDURE SQL4304RC1
2. 修正 EXTERNAL NAME 拼寫
3. 重新創建存儲過程並測試調用

SQL4304 RC=2 —— 類繼承關係錯誤或方法聲明為 static

使用 PARAMETER STYLE DB2GENERAL 時，Java 存儲過程類必須繼承 COM.ibm.db2.app.StoredProc。此外，入口方法不能聲明為 public static，必須是實例方法。

錯誤代碼片段：

public class SQL4304RC2 {  // 缺少 extends StoredProc
    public static void abend(int input) { ... }  // 不能是 static
}

正確代碼：

public class SQL4304RC2 extends COM.ibm.db2.app.StoredProc {
    public void abend(int input) throws SQLException, Exception { ... }
}

修正後重新編譯、替換 sqllib/function 下的 class 文件即可。

SQL4306：Java 方法簽名不匹配

當 EXTERNAL NAME 指定的方法名與 Java 源碼中的方法名大小寫不一致，或參數類型/個數不匹配時觸發。

案例： Java 方法為 public static void iNSERT(String input)（小寫 i），但 EXTERNAL NAME 'INSERT.INSERT' 使用大寫 I。DB2 按 JVM 類型簽名 (Ljava/lang/String;)V 查找方法，發現不匹配。

解決方案： 修正 CREATE PROCEDURE 中的 EXTERNAL NAME 為 'INSERT.iNSERT'，或統一 Java 方法名大小寫。

JVM 類型簽名速查表：

詳細規範請參考 JNI 類型簽名文檔。

SQL20200 / SQL20201：JAR 文件管理錯誤

SQL20200 —— JAR 文件不存在或路徑錯誤

調用 sqlj.install_jar 時指定的 JAR 文件路徑無效，或文件尚未創建。

修正： 先執行 jar -cvf Out_20200.jar *.class 生成 JAR，再安裝。

SQL20201 —— JAR ID 無效或重複安裝未先移除

• 場景一：重新安裝同名 JAR 前未執行 sqlj.remove_jar → 需先移除或改用 sqlj.replace_jar
• 場景二：移除 JAR 時 JAR ID 拼寫錯誤 → 核對 sqlj.install_jar 時使用的 ID（如 OUT20200JAR 而非 OUT20200）

SQL20204 / SQL0449：EXTERNAL NAME 格式錯誤

Java 存儲過程的 EXTERNAL NAME 必須遵循以下格式：

['jar_id':]class_id[.|!]method_id

// 第 23 行導致 JVM 退出
java.lang.Runtime.getRuntime().exit(0);