Java调用Oracle返回REF CURSOR的函数必须用CallableStatement并注册Types.OTHER，否则抛Invalid column type异常；函数内禁用DML，否则触发ORA-14551；推荐12c+改用JSON字符串替代游标。
Oracle函数返回REF CURSOR时，Java必须用CallableStatement注册Types.OTHER
oracle的pl/sql函数若返回sys_refcursor（即记录集），java无法用preparedstatement处理——它只支持单值结果。必须用callablestatement调用，并显式注册out参数类型为types.other，否则会抛sqlexception: invalid column type。
常见错误是把函数当存储过程用executeUpdate()，或漏掉registerOutParameter。正确流程是：
- SQL字符串形如
{? = call my_pkg.get_data(?)}（问号顺序严格对应：第一个?是返回值，后续是IN参数） - 调用
cs.registerOutParameter(1, Types.OTHER)，索引从1开始 - 执行后用
cs.getObject(1)拿到ResultSet对象，再强转
示例片段：
String sql = "{? = call pkg_data.get_users(?)}";
CallableStatement cs = conn.prepareCall(sql);
cs.registerOutParameter(1, Types.OTHER);
cs.setString(2, "ACTIVE");
cs.execute();
ResultSet rs = (ResultSet) cs.getObject(1); // 注意强转
函数体里不能有DML操作，否则JDBC调用会报ORA-14551
如果Oracle函数内部执行了INSERT/UPDATE/DELETE，哪怕加了PRAGMA AUTONOMOUS_TRANSACTION，JDBC仍可能触发ORA-14551: cannot perform a DML operation inside a query。这是因为JDBC默认以SELECT上下文调用函数，而Oracle禁止在纯查询中修改数据。
解决方法只有两个：
立即学习“Java免费学习笔记（深入）”；
- 把函数改写为存储过程（
PROCEDURE），用CallableStatement.execute()调用，不依赖返回值 - 彻底移除函数内的DML，把写操作拆到调用方Java代码里完成
别试图用SET TRANSACTION READ WRITE绕过——它对函数调用无效。
Oracle 12c+支持JSON_TABLE，Java可直接取JSON字符串避免REF CURSOR
如果Oracle版本≥12.1，且函数逻辑允许，更轻量的做法是让函数返回CLOB类型的JSON字符串（用JSON_OBJECT等构造），Java端用cs.getClob(1)读取后解析。这样避开REF CURSOR的驱动兼容性问题（尤其旧版ojdbc6对Types.OTHER支持不稳定）。
优势明显：
- 不用强转
ResultSet，无类型擦除风险 - JSON字段名、嵌套结构由SQL控制，Java侧更灵活
- ojdbc7+对
CLOB读取性能优于游标多次fetch
对应SQL示例：
FUNCTION get_users_json(p_status VARCHAR2) RETURN CLOB IS l_json CLOB; BEGIN SELECT JSON_OBJECT(*) INTO l_json FROM users WHERE status = p_status; RETURN l_json; END;
ojdbc驱动版本和连接属性影响REF CURSOR行为
ojdbc6默认关闭隐式游标关闭，可能导致连接池里连接被长时间占用；ojdbc8在implicitCachingEnabled=true时会自动close游标，但要求函数返回的游标未被Java显式close。容易踩的坑：
- 用完
ResultSet后没调rs.close()，下一次调用同一连接会报ORA-01000: maximum open cursors exceeded - 连接URL里漏配
oracle.jdbc.autoCommitSpecCompliant=false，某些事务场景下游标提前失效 - Web应用中，若函数返回大量数据，建议在
CallableStatement上设setFetchSize(100)防内存溢出
真正麻烦的是跨不同Oracle小版本（比如11gR2 vs 19c）时，REF CURSOR的元数据获取方式有差异，rs.getMetaData().getColumnCount()可能返回0——这时得靠已知列名硬编码处理，没法完全动态。
