1. 为什么你写的 ref cursor 总是报错刚接触 Oracle PL/SQL 的人第一次写游标变量ref cursor时十有八九会遇到ORA-01001: invalid cursor或者PLS-00382: expression is of wrong type。原因往往不是语法写错了而是没搞清楚一件事游标变量和普通游标是两种东西它们的生命周期、类型约束、打开方式都不一样。普通游标CURSOR c IS SELECT ...在声明时就绑定了 SQL 语句编译期就确定了结果集结构。而 ref cursor 是一个指向结果集的指针声明时不绑定查询运行时才通过OPEN ... FOR决定查什么。这个灵活性带来了两个后果一是强类型和弱类型的区分变得关键二是打开、取值、关闭的顺序一旦搞错就直接报错。这篇内容面向正在写存储过程、函数或者需要把结果集在 PL/SQL 和 Java/Python 之间传递的开发者。我会从声明格式讲起把强类型、弱类型、SYS_REFCURSOR三种写法都跑一遍再结合动态 SQL 演示OPEN FOR拼接语句的用法最后给出可复制的验证脚本和常见报错排查表。你跟着敲一遍基本就能在自己的 Oracle 环境里跑通。2. 前置准备环境与 TaoToken 接入2.1 Oracle 环境要求你需要一个能执行 PL/SQL 的 Oracle 实例11g、12c、19c、21c 都可以本文的语法在这些版本上通用。连接工具用 SQL*Plus、SQL Developer、DBeaver 或者 Navicat 都行关键是能执行SET SERVEROUTPUT ON看到DBMS_OUTPUT的输出。如果你本地没有 Oracle可以用 Oracle 官方提供的 Live SQL 在线环境或者用 Docker 起一个container-registry.oracle.com/database/free镜像几分钟就能跑起来。建库之后确认一下当前用户有CREATE PROCEDURE、CREATE TABLE权限普通开发用户一般都有。2.2 用 TaoToken 辅助生成和调试 PL/SQL写 PL/SQL 的时候我经常需要快速生成一段游标变量的骨架或者让模型帮我解释某个报错。这时候用 TaoToken 的模型对话能力比较顺手它支持把 Oracle 的报错信息直接贴进去问原因。如果你要长期写存储过程、做数据库相关的编码工作可以走 Coding Plan把常用的 PL/SQL 模板沉淀下来。接入方式很简单先到控制台创建一个 API Key然后在你的客户端或脚本里配置。API 地址是https://taotoken.net/api模型对话入口在 deep link 里可以直接打开。下面给一个用 curl 调用模型对话接口的最小示例你可以用它来问 Oracle 游标相关的问题curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [ {role: user, content: Oracle PL/SQL 中强类型 ref cursor 和弱类型 ref cursor 的区别是什么各给一个例子} ] }拿到 Key 之后建议先做一次连通性验证确认返回 200 和正常的 JSON 结构再进入下面的 PL/SQL 实操。API Key 的创建入口在控制台的 API Keys 页面接入文档里有完整的参数说明。3. 可复制配置从声明到动态 SQL 的完整骨架3.1 强类型游标变量声明时绑定返回结构强类型的意思是TYPE ... IS REF CURSOR RETURN ...后面跟了返回类型编译期就检查FETCH INTO的变量是否匹配。先建一张测试表后面所有例子都用它CREATE TABLE employees ( empid NUMBER(5), empname VARCHAR2(30), salary NUMBER(8,2) ); INSERT INTO employees VALUES (1, Dan Morgan, 5000); INSERT INTO employees VALUES (2, Hans Forbrich, 6200); INSERT INTO employees VALUES (3, Caleb Small, 4800); COMMIT;强类型游标变量的声明和打开SET SERVEROUTPUT ON DECLARE TYPE emp_cur_typ IS REF CURSOR RETURN employees%ROWTYPE; emp_cv emp_cur_typ; emp_rec employees%ROWTYPE; BEGIN OPEN emp_cv FOR SELECT * FROM employees WHERE salary 4900; LOOP FETCH emp_cv INTO emp_rec; EXIT WHEN emp_cv%NOTFOUND; DBMS_OUTPUT.PUT_LINE(Name || emp_rec.empname || , Salary || emp_rec.salary); END LOOP; CLOSE emp_cv; END; /这里emp_cur_typ绑定了employees%ROWTYPE所以FETCH emp_cv INTO emp_rec必须用同结构的记录变量否则编译不过。这就是强类型的约束力。3.2 弱类型与 SYS_REFCURSOR不绑定返回结构弱类型就是TYPE ... IS REF CURSOR;后面不跟 RETURN结果集结构运行时才确定。Oracle 还预定义了一个SYS_REFCURSOR等价于弱类型日常开发用得最多DECLARE TYPE generic_cur_typ IS REF CURSOR; -- 弱类型 cur1 generic_cur_typ; cur2 SYS_REFCURSOR; -- 预定义弱类型 v_name VARCHAR2(30); v_sal NUMBER(8,2); BEGIN OPEN cur2 FOR SELECT empname, salary FROM employees WHERE empid 1; FETCH cur2 INTO v_name, v_sal; DBMS_OUTPUT.PUT_LINE(Name || v_name || , Salary || v_sal); CLOSE cur2; END; /弱类型的好处是同一个游标变量可以在不同时刻打开成不同结构的查询代价是编译期不检查FETCH INTO的列数和类型错了要到运行时才报ORA-01007或ORA-06502。3.3 动态 SQL 场景OPEN FOR 拼接语句ref cursor 真正发挥威力的地方是动态 SQL。你可以根据参数拼接不同的 WHERE 条件然后用同一个游标变量打开CREATE OR REPLACE PROCEDURE query_emp ( p_min_sal IN NUMBER, p_cursor OUT SYS_REFCURSOR ) IS v_sql VARCHAR2(1000); BEGIN v_sql : SELECT empid, empname, salary FROM employees WHERE 11; IF p_min_sal IS NOT NULL THEN v_sql : v_sql || AND salary :1; END IF; v_sql : v_sql || ORDER BY empid; IF p_min_sal IS NOT NULL THEN OPEN p_cursor FOR v_sql USING p_min_sal; ELSE OPEN p_cursor FOR v_sql; END IF; END; /注意OPEN ... FOR后面跟字符串变量时绑定变量用:1、:2占位再用USING传值。这样既避免了拼接注入也让执行计划可以复用。调用和验证SET SERVEROUTPUT ON DECLARE v_cur SYS_REFCURSOR; v_id NUMBER; v_nm VARCHAR2(30); v_sal NUMBER(8,2); BEGIN query_emp(4900, v_cur); LOOP FETCH v_cur INTO v_id, v_nm, v_sal; EXIT WHEN v_cur%NOTFOUND; DBMS_OUTPUT.PUT_LINE(v_id || | || v_nm || | || v_sal); END LOOP; CLOSE v_cur; END; /3.4 在包中声明游标变量并作为参数传递ref cursor 最常见的用途是作为存储过程的 OUT 参数把结果集返回给调用方。在包规范里声明类型包体里实现CREATE OR REPLACE PACKAGE emp_pkg AS TYPE emp_cur_typ IS REF CURSOR RETURN employees%ROWTYPE; PROCEDURE open_emp_cv (p_cv IN OUT emp_cur_typ, p_min_sal IN NUMBER); END emp_pkg; / CREATE OR REPLACE PACKAGE BODY emp_pkg AS PROCEDURE open_emp_cv (p_cv IN OUT emp_cur_typ, p_min_sal IN NUMBER) IS BEGIN OPEN p_cv FOR SELECT * FROM employees WHERE salary p_min_sal; END open_emp_cv; END emp_pkg; /调用时注意IN OUT的游标变量在传入前不需要打开过程内部负责 OPEN调用方负责 FETCH 和 CLOSE。这个职责划分搞反了就会报ORA-01001。3.5 用 BULK COLLECT 批量取值到集合逐行 FETCH 在数据量大时性能一般可以用BULK COLLECT一次性取到集合DECLARE TYPE name_list IS TABLE OF employees.empname%TYPE; TYPE sal_list IS TABLE OF employees.salary%TYPE; v_cur SYS_REFCURSOR; v_names name_list; v_sals sal_list; BEGIN OPEN v_cur FOR SELECT empname, salary FROM employees ORDER BY empid; FETCH v_cur BULK COLLECT INTO v_names, v_sals; CLOSE v_cur; FOR i IN 1 .. v_names.COUNT LOOP DBMS_OUTPUT.PUT_LINE(Name || v_names(i) || , Salary || v_sals(i)); END LOOP; END; /BULK COLLECT会把所有行一次取完适合结果集可控的场景。如果结果集很大建议配合LIMIT分批取避免 PGA 内存暴涨。4. 验证请求与成功结果4.1 验证强类型游标执行 3.1 的代码块预期输出NameDan Morgan, Salary5000 NameHans Forbrich, Salary6200如果只输出一行或者报ORA-01001检查CLOSE是否在循环外、EXIT WHEN是否写在FETCH之后。4.2 验证动态 SQL 过程执行 3.3 的调用块传入4900预期输出1 | Dan Morgan | 5000 2 | Hans Forbrich | 6200传入NULL时应该返回全部三行。如果报ORA-01006: bind variable does not exist说明USING的变量个数和 SQL 里的占位符对不上。4.3 验证包中的游标变量SET SERVEROUTPUT ON DECLARE v_cv emp_pkg.emp_cur_typ; v_rec employees%ROWTYPE; BEGIN emp_pkg.open_emp_cv(v_cv, 5000); LOOP FETCH v_cv INTO v_rec; EXIT WHEN v_cv%NOTFOUND; DBMS_OUTPUT.PUT_LINE(v_rec.empid || - || v_rec.empname); END LOOP; CLOSE v_cv; END; /预期输出两行salary 5000 的记录。这里v_cv的类型必须用emp_pkg.emp_cur_typ不能用SYS_REFCURSOR因为强类型不兼容。4.4 用模型对话快速核对语法如果你对某个写法不确定可以把代码片段贴到模型对话里让它检查。比如问「这段 OPEN FOR USING 的绑定变量顺序对不对」模型会逐行分析。接入方式还是https://taotoken.net/apiKey 在控制台创建。对于长期做数据库开发的人Coding Plan 可以把这类问答和代码生成串起来省去反复切换工具的时间。5. 本篇常见报错排查5.1 ORA-01001: invalid cursor最常见的原因是游标没打开就 FETCH或者已经 CLOSE 了还在 FETCH。检查三点OPEN是否在FETCH之前执行CLOSE是否误写在循环内部异常处理里是否重复 CLOSE。用%ISOPEN做防御IF NOT emp_cv%ISOPEN THEN OPEN emp_cv FOR SELECT * FROM employees; END IF;5.2 PLS-00382: expression is of wrong type强类型游标变量和FETCH INTO的记录变量结构不匹配时触发。比如游标返回employees%ROWTYPE你却用SYS_REFCURSOR去接或者FETCH INTO的变量列数不对。解决办法是统一类型要么都用强类型要么都用SYS_REFCURSOR加显式变量列表。5.3 ORA-01007: variable not in select list弱类型游标 FETCH 时INTO 后面的变量个数和 SELECT 的列数不一致。弱类型编译期不检查所以这个错只在运行时暴露。建议在OPEN FOR之后立刻 FETCH 一行做冒烟测试或者用%ROWTYPE记录变量接整行。5.4 ORA-06502: numeric or value error通常是FETCH INTO的变量长度不够比如VARCHAR2(10)去接一个 30 字符的列。把变量声明成%TYPE或者%ROWTYPE可以避免大部分这类问题。5.5 游标变量不能做的几件事有几个限制容易踩坑不能在包规范里声明游标变量只能在包体或子程序里不能用比较两个游标变量不能把游标变量存到表列里不能放进关联数组、嵌套表或 VARRAY普通游标和游标变量之间不能互相赋值。这些限制在编译期或运行期都会报错写的时候避开就行。报错码触发场景排查方向ORA-01001未打开/已关闭就 FETCH检查 OPEN/CLOSE 顺序用 %ISOPEN 防御PLS-00382强类型结构不匹配统一游标类型与 INTO 变量结构ORA-01007弱类型列数不一致核对 SELECT 列数与 INTO 变量数ORA-06502变量长度不足用 %TYPE/%ROWTYPE 声明变量ORA-01006USING 绑定变量个数不符核对占位符与 USING 参数6. 继续深入把 ref cursor 用进真实项目到这里声明、打开、取值、关闭的全流程你已经跑通了。强类型适合结构固定的场景编译期就能挡住大部分错误弱类型和SYS_REFCURSOR适合动态 SQL 和跨语言传参灵活但需要自己保证结构一致。动态 SQL 里用OPEN FOR ... USING绑定变量既安全又能复用执行计划。下一步可以练的方向把query_emp改造成支持多条件动态拼接用DBMS_SQL处理更复杂的动态场景或者在 Java 侧用 JDBC 的CallableStatement接收SYS_REFCURSOR返回的结果集。如果你在写这些代码时需要快速查语法或排查报错可以到模型对话里直接问接入地址是https://taotoken.net/apiAPI Key 在控制台创建。长期做数据库开发的话Coding Plan 能把常用的 PL/SQL 模板和排错经验沉淀下来减少重复劳动。