如何在Oracle中使用REF CURSOR实现存储过程返回动态结果集？-Oracle-PHP中文网

必须用sys_refcursor而非自定义ref cursor，因其是oracle内置弱类型游标，不校验列名、数量及类型，支持运行时动态打开任意结构查询；而自定义ref cursor为强类型，编译期绑定结构，稍有变更即触发pls-00382错误，且客户端和jdbc仅原生识别sys_refcursor。

sys_refcursor 是唯一能安全返回动态结果集的类型，用自定义 ref cursor 会因结构不匹配直接报 pls-00382 错误。

为什么必须用 `SYS_REFCURSOR` 而不是自定义 `REF CURSOR`

自定义类型（如 TYPE mycur IS REF CURSOR）是强类型的：它在编译期就绑定固定列名、数量和类型，哪怕只多一个字段或改个顺序，调用时就会触发 PLS-00382: expression is of wrong type。而 SYS_REFCURSOR 是 Oracle 内置的弱类型游标，不校验结构，同一变量可先后打开 SELECT id, name FROM t1 和 SELECT x, y, z FROM t2。

客户端工具（SQL Developer、Toad）和 JDBC 都原生识别 SYS_REFCURSOR；若用自定义类型，包声明、包体、调用方变量三处类型必须完全一致，极易因表结构变更导致编译失败。

动态 SQL 场景（EXECUTE IMMEDIATE + OPEN FOR）下，只有 SYS_REFCURSOR 支持运行时任意结构
OUT SYS_REFCURSOR 是跨作用域传递结果集的唯一合法方式；显式游标（如 CURSOR c IS SELECT...）无法作为参数传出

`OPEN FOR` 的写法与常见错误

SYS_REFCURSOR 变量不能用 := 直接赋值查询结果——那是给标量或记录用的语法。必须用 OPEN p_out FOR ...，且该语句只能出现在 BEGIN 块内，不能放在声明区或 EXCEPTION 中（除非重新 OPEN）。

正确示例：

CREATE OR REPLACE PROCEDURE get_users(p_dept_id IN NUMBER, p_out OUT SYS_REFCURSOR) IS
BEGIN
  OPEN p_out FOR 
    SELECT id, name, salary FROM users 
    WHERE dept_id = p_dept_id AND status = 'ACTIVE';
END;

错误写法（会编译失败）：

QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载

-- ❌ 编译报错 PLS-00382
p_out := SELECT * FROM dual;

查询中可安全使用输入参数（如 p_dept_id），Oracle 自动做绑定，避免 SQL 注入
若需拼接动态 SQL（如条件字段可选），必须配合 EXECUTE IMMEDIATE，但字符串拼接要严格校验表名/字段名白名单，不能仅依赖游标“隔离”

Java/JDBC 调用时必须显式注册 `OracleTypes.CURSOR`

ODP.NET 或 JDBC 不会自动识别 OUT SYS_REFCURSOR 参数。JDBC 必须调用 registerOutParameter(?, Types.OTHER) 并指定 OracleTypes.CURSOR；ODP.NET Core 8.0 则需用 OracleCommand.Parameters.Add("p_out", OracleDbType.RefCursor).Direction = ParameterDirection.Output。

直接把游标当返回值用（像 SQL Server 返回 DataTable 那样）会报 ORA-06550 和 PLS-00306 错误，因为驱动不自动绑定输出参数。

SQL*Plus 或 SQL Developer 中测试，需先执行 VAR cur REFCURSOR，再 EXEC proc_name(:cur)，最后 PRINT cur
MyBatis 封装时，@SelectProvider 动态生成的 SQL 不能替代存储过程中的 OPEN FOR，二者用途不同

多个结果集要多个 `OUT SYS_REFCURSOR` 参数

Oracle 不支持单条命令返回多个结果集。要返回员工+部门两套数据，就得声明两个输出参数：

PROCEDURE get_emp_dept(
  cur_emp OUT SYS_REFCURSOR,
  cur_dept OUT SYS_REFCURSOR
) IS
BEGIN
  OPEN cur_emp FOR SELECT * FROM employees;
  OPEN cur_dept FOR SELECT * FROM departments;
END;

调用方也得准备两个对应变量接收，JDBC 中要分别注册、分别 getResultSet()。

容易被忽略的是：每个 OPEN FOR 都独立占用服务器游标资源，长时间未关闭可能触发 ORA-01000: maximum open cursors exceeded —— 这类资源泄漏不会在存储过程中暴露，得靠应用层及时关闭 ResultSet 和 Statement。