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