Java调用带命名参数的DB2存储过程报错（ERRORCODE=-4472）

问题重现 #

用户尝试通过Java调用DB2带命名参数的存储过程，代码如下：

Class.forName("com.ibm.db2.jcc.DB2Driver");
String connectionFormat = "jdbc:db2://TEST.NET:5224/D1278";
Connection conn = DriverManager.getConnection(connectionFormat, User.USERNAME, User.PASSWORD);
CallableStatement statement = conn.prepareCall("CALL SAMPLE.ESPA(PLAN=>?,LIB=>?,PARMS=>?)");
statement.setString("PLAN", "TEST1");
statement.setString("LIB", "'FTM.STORED.PROC'");
statement.setString("PARMS", "010000");

执行后出现报错：

com.ibm.db2.jcc.am.SqlException: [jcc][10453][12710][4.28.11] Cannot get the describe information for the calling stored procedure with name ESPA and path ' SYSIBM , SYSFUN , SYSPROC , SYSIBMADM ,
USER1' ERRORCODE=-4472, SQLSTATE=null
    at com.ibm.db2.jcc.am.b7.a(b7.java:794)
    at com.ibm.db2.jcc.am.b7.a(b7.java:66)
    at com.ibm.db2.jcc.am.b7.a(b7.java:107)
    at com.ibm.db2.jcc.am.CallableStatement.b0(CallableStatement.java:2291)
    at com.ibm.db2.jcc.am.CallableStatement.w(CallableStatement.java:2193)
    at com.ibm.db2.jcc.am.CallableStatement.setString(CallableStatement.java:1405)
    at com.ca.mat.agent.storedproc.ExecuteProcedure.<init>(ExecuteProcedure.java:56)
    at com.ca.mat.agent.storedproc.ExecuteProcedure.main(ExecuteProcedure.java:89)

错误原因分析 #

ERRORCODE=-4472本质是JDBC驱动无法获取目标存储过程的元数据信息，常见触发原因包括：

• 存储过程的Schema或名称错误，驱动找不到对应存储过程
• 命名参数的语法不符合DB2 JDBC的规范
• 连接用户无权限访问存储过程或系统元数据表
• JDBC驱动版本与DB2服务器版本不兼容
• 参数值格式错误（比如多余的单引号）

解决方案 #

1. 验证存储过程的存在性与权限 #

在DB2客户端执行以下SQL，确认存储过程是否存在，且当前用户有权限访问：

SELECT * FROM SYSIBM.SYSPROCEDURES 
WHERE PROCNAME='ESPA' AND SCHEMANAME='SAMPLE';

如果存储过程存在但无权限，执行授权语句：

GRANT EXECUTE ON PROCEDURE SAMPLE.ESPA TO USER [你的用户名];

2. 修正命名参数语法 #

DB2 JDBC对命名参数的语法有明确要求，不能直接使用PLAN=>?的形式，需改为:参数名的绑定方式：

CallableStatement statement = conn.prepareCall("CALL SAMPLE.ESPA(PLAN => :PLAN, LIB => :LIB, PARMS => :PARMS)");
statement.setString("PLAN", "TEST1");
statement.setString("LIB", "FTM.STORED.PROC"); // 去掉多余的单引号
statement.setString("PARMS", "010000");

如果不需要严格使用命名参数，更稳妥的方式是按位置绑定（兼容所有JDBC版本）：

CallableStatement statement = conn.prepareCall("CALL SAMPLE.ESPA(?, ?, ?)");
statement.setString(1, "TEST1");
statement.setString(2, "FTM.STORED.PROC");
statement.setString(3, "010000");

3. 移除参数中的多余单引号 #

代码中LIB参数传入了带单引号的'FTM.STORED.PROC'，JDBC会自动处理字符串的转义，无需手动添加单引号，否则会导致实际参数值包含引号，不符合存储过程的预期。

4. 检查JDBC驱动版本兼容性 #

当前使用的驱动版本为4.28.11，需确认该版本与DB2服务器版本匹配。如果版本不兼容，建议下载对应DB2版本的最新JDBC驱动替换。

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