Java应用调用含REF CURSOR输入参数的Oracle存储过程问题

嗨，我来帮你搞定这两个Java调用Oracle存储过程时的常见问题，这俩坑我之前也踩过，给你一步步讲清楚：

一、如何处理REF CURSOR类型的req_curtype参数 #

Oracle的REF CURSOR在Java中对应的是ResultSet对象，你不需要手动创建Ref对象，而是通过CallableStatement的registerOutParameter方法来注册这个输出参数，指定类型为OracleTypes.CURSOR（需要导入oracle.jdbc.OracleTypes包）。

给你一个完整的代码示例，假设你的存储过程定义大概是这样：

CREATE OR REPLACE PROCEDURE YOUR_PROC_NAME(
    req_curtype OUT SYS_REFCURSOR,
    p_num OUT NUMBER,
    p_str OUT VARCHAR2,
    p_input IN VARCHAR2 -- 假设你有一个输入字符串参数
) AS
BEGIN
    -- 存储过程逻辑：查询数据并赋值给REF CURSOR和其他输出参数
    OPEN req_curtype FOR SELECT ... FROM ...;
    p_num := 123;
    p_str := '测试字符串';
END;

对应的Java调用代码：

import java.sql.CallableStatement;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import oracle.jdbc.OracleTypes;

public class CallOracleProc {
    public static void main(String[] args) {
        String jdbcUrl = "jdbc:oracle:thin:@//your-db-host:1521/your-sid";
        String username = "your-username";
        String password = "your-password";
        
        try (Connection conn = DriverManager.getConnection(jdbcUrl, username, password)) {
            // 注意存储过程调用的语法：{call 过程名(参数1, 参数2, ...)}
            String procSql = "{call YOUR_PROC_NAME(?, ?, ?, ?)}";
            CallableStatement cs = conn.prepareCall(procSql);
            
            // 1. 注册OUT参数：顺序要和存储过程的参数顺序完全一致
            cs.registerOutParameter(1, OracleTypes.CURSOR); // 对应req_curtype（REF CURSOR）
            cs.registerOutParameter(2, OracleTypes.NUMBER); // 对应p_num
            cs.registerOutParameter(3, OracleTypes.VARCHAR); // 对应p_str
            // 2. 设置IN参数（如果有的话）
            cs.setString(4, "你的输入字符串");
            
            // 执行存储过程
            cs.execute();
            
            // 3. 获取输出结果
            // 处理REF CURSOR：转换成ResultSet
            ResultSet rs = (ResultSet) cs.getObject(1);
            while (rs.next()) {
                // 读取游标里的数据，比如rs.getInt("列名")、rs.getString("列名")
                System.out.println("游标数据：" + rs.getString("COLUMN_NAME"));
            }
            // 获取数字输出参数
            int numResult = cs.getInt(2);
            // 获取字符串输出参数
            String strResult = cs.getString(3);
            
            System.out.println("数字结果：" + numResult);
            System.out.println("字符串结果：" + strResult);
            
            // 关闭资源
            rs.close();
            cs.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

关键注意点：

• 参数顺序必须和存储过程定义的顺序完全匹配，不要搞混IN和OUT参数的位置
• 注册OUT参数时，REF CURSOR必须用OracleTypes.CURSOR，不能用其他类型

二、OUT参数被要求传入输入值的问题 #

你遇到的这个错误，大概率是参数顺序搞反了，或者把OUT参数当成了IN/IN OUT参数来设置值。

核心知识点： #

• 纯OUT参数：只需要用registerOutParameter注册，不需要调用setXxx方法传入值，存储过程会在执行后给它赋值，你只需要在执行后调用getXxx获取结果
• 如果是IN OUT参数：才需要先调用setXxx传入初始值，执行后再用getXxx获取更新后的值

排查步骤： #

1. 仔细核对存储过程的参数定义，确认每个参数是IN、OUT还是IN OUT
2. 检查Java代码中registerOutParameter和setXxx的顺序，确保OUT参数没有被错误地调用setXxx
3. 确认调用存储过程的SQL里的问号顺序和存储过程参数顺序完全一致

举个反例（错误写法）：如果把OUT参数当成IN参数设置值，就会报错：

// 错误！req_curtype是OUT参数，不需要set
cs.setObject(1, someValue);

只要修正参数的注册和设置逻辑，这个错误就能解决。

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