如何在Java中使用Oracle的游标SYS_REFCURSOR_返回结果集并在Java中遍历

oracle存储过程需定义SYS_REFCURSOR类型OUT参数，Java通过registerOutParameter(OracleTypes.CURSOR)注册并用getCursor()/getObject()获取ResultSet，注意字段名大小写、显式关闭及游标数量限制。

Oracle存储过程怎么定义SYS_REFCURSOR输出参数

java没法直接“接收”游标，必须靠oracle存储过程把结果集绑定到sys_refcursor类型的out参数上，再由jdbc用registeroutparameter声明它。常见错误是把游标当成普通查询结果——比如在pl/sql里写return ref_cursor，或试图用executequery()直接调用带游标的存储过程，这都会报ora-06550或invalid column type。

正确做法是：在存储过程中声明OUT p_cursor OUT SYS_REFCURSOR，然后用OPEN p_cursor for select ...打开；Java端用CallableStatement，对对应位置调用registerOutParameter(idx, OracleTypes.CURSOR)。

• 必须用OracleTypes.CURSOR（不是Types.OTHER或Types.JAVA_OBJECT），否则驱动不认识
• 如果用spring JDBC，要用SqlOutParameter("p_cursor", OracleTypes.CURSOR)，不能写new SqlOutParameter(..., Types.OTHER)
• Oracle 12c+支持REF CURSOR作为函数返回值，但JDBC仍需走OUT参数路径，函数体里不能直接RETURN游标变量

JDBC怎么获取并遍历SYS_REFCURSOR返回的ResultSet

注册完OUT参数后，调用execute()，再用getCursor(idx)或getObject(idx)拿到ResultSet——注意不是getString()或getInt()。很多人卡在这一步，以为要先next()再取值，其实和普通ResultSet一样操作，只是来源不同。

示例关键片段：

cs.registerOutParameter(2, OracleTypes.CURSOR); cs.execute(); ResultSet rs = (ResultSet) cs.getObject(2); // 或 cs.getCursor(2) while (rs.next()) {     String name = rs.getString("name");     int age = rs.getInt("age"); }

• getCursor()是Oracle JDBC特有方法，更语义清晰；getObject()通用但需强转
• 游标打开后必须显式close()，否则连接池里连接可能被锁住，尤其在使用try-with-resources时要注意ResultSet是否被正确包裹
• 不要在存储过程中对游标做FETCH或CLOSE，JDBC会自动管理底层资源（除非用REF CURSOR变量做多层嵌套）

为什么ResultSet字段名大小写不一致或取不到列

Oracle默认把未加双引号的列名转成大写，而JDBC驱动默认按原样匹配字段名。如果你SELECT里写SELECT user_name FROM...，Java里用rs.getString("user_name")会返回NULL，但rs.getString("USER_NAME")才对。这是最常被忽略的兼容性坑。

立即学习“Java免费学习笔记（深入）”；

• 要么在SQL里给列加双引号：SELECT "user_name" FROM...，保持小写可读性
• 要么统一用大写取值：rs.getString("USER_NAME")，适合已有老代码
• 用rs.getMetaData().getColumnName(i)动态查实际列名，避免硬编码（尤其涉及动态SQL或视图）
• 别依赖rs.findColumn()——它不区分大小写但行为不稳定，Oracle驱动某些版本下会失败

spring boot里用JdbcTemplate调用带SYS_REFCURSOR的存储过程

直接用JdbcTemplate.call()容易出错，因为默认不支持CURSOR类型映射。必须用SimpleJdbcCall并显式配置declareParameters()，否则会抛InvalidDataAccessResourceUsageException: Invalid column type。

• 必须声明new SqlOutParameter("p_cursor", OracleTypes.CURSOR, new ResultSetExtractor<list object>>>() {...})</list>
• 推荐用Lambda写new ResultSetExtractor()，但注意提取逻辑里仍要处理字段名大小写问题
• 如果只想要List
  
• 别在@Transactional方法里调用多个带游标的存储过程——每个游标都占一个数据库游标句柄，Oracle默认限制是300，容易触发ORA-01000: maximum open cursors exceeded

Oracle的SYS_REFCURSOR本质是服务端的一次性结果集指针，Java端拿到的是它的客户端代理。真正麻烦的从来不是“怎么取”，而是“取完没关”“字段名写错”“游标开太多”——这些点不盯紧，上线后问题往往出现在高并发或长时间运行时。