1. 显式游标到底解决什么问题：从一次批量涨薪说起
PLSQL 游标（Cursor）是 Oracle 里处理「一行一行数据」的核心工具。你可以把它理解成一个指向查询结果集的指针：查询语句执行后结果集可能有很多行，游标帮你一行一行地取出来处理，处理完再关掉。日常开发里最常见的场景就是批量作业——比如按部门给员工调薪、按订单状态逐条更新、把某张表的数据逐行写入日志表。这些操作如果只用一条UPDATE搞不定（因为每行逻辑不同），游标就是最直接的解法。
我见过不少刚接触 PLSQL 的朋友，第一反应是用SELECT ... INTO去接数据，结果一遇到多行就报ORA-01422: exact fetch returns more than requested number of rows。这个报错的本质是：SELECT INTO只接受一行，多一行就炸。而显式游标天生就是为多行设计的，配合LOOP + FETCH + EXIT WHEN三件套，逐行处理稳得很。
这篇内容面向的是日常做 Oracle 数据处理的开发者，尤其是需要写存储过程、定时批量任务的场景。我会从最基础的显式游标声明讲起，再到带参数游标、sys_refcursor系统引用游标，最后给一个「按职位涨薪」的完整实战案例。每一步都给出可直接复制到 SQL*Plus 或 IDE（比如 PL/SQL Developer、DBeaver）里跑的代码，并且告诉你执行后应该看到什么结果。如果你之前写游标总是记不住OPEN/FETCH/CLOSE的顺序，或者带参数游标传参老是搞混，这篇可以当作一份可跟做的操作手册。
先明确一个概念：Oracle 里的游标分两类。一类是显式游标，就是你自己用CURSOR xxx IS SELECT ...声明的，完全由你控制打开、取值、关闭。另一类是隐式游标，比如你执行一条UPDATE，Oracle 内部自动帮你维护一个叫SQL的隐式游标，你可以用SQL%ROWCOUNT拿到影响行数。本文重点讲显式游标，因为批量逐行处理几乎都靠它。
还有一个容易混淆的点：游标和循环不是一回事。游标负责「结果集 + 当前行指针」，循环负责「反复取值」。很多人写游标时把EXIT WHEN写错位置，导致死循环或者漏掉最后一行，后面排障章节我会专门讲这个坑。
显式游标的生命周期固定四步：声明（DECLARE 区）→ 打开（OPEN）→ 取值循环（FETCH）→ 关闭（CLOSE）。记住这个顺序，后面所有变体都是在这个骨架上加东西。带参数游标无非是在声明时加参数、打开时传值；sys_refcursor无非是把「声明时绑定 SQL」改成「打开时动态绑定 SQL」。骨架不变，理解起来就轻松了。
2. TaoToken 前置准备：把模型对话和编码计划接进来辅助写游标
写 PLSQL 游标这类偏模板化的代码，其实很适合让大模型帮你生成初稿，然后你自己改参数、改表名。我平时会用 TaoToken 的模型对话来快速产出游标模板，再用 Coding Plan 处理更长的存储过程逻辑。这里先把接入的前置动作说清楚，后面你就能直接复制配置去用。
TaoToken 的官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api （这个不加 UTM）。你需要先拿到 API Key，入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。拿到 Key 之后，模型对话页面在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，Coding Plan 在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。
如果你用的是 Claude Code 这类命令行编码工具，它的 Anthropic 兼容接入说明在 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_code&utm_campaign=rewrite 。这里要强调一个原则：TaoToken 是模型调用入口，不是数据库工具，它不会替你去连 Oracle，也不会替代你的 IDE。它的作用是帮你生成、解释、排障游标代码，真正执行还是在你本地的 SQL*Plus 或 IDE 里。
为什么写游标要用到它？因为游标代码有几个高频出错点：%ROWTYPE和%TYPE混用、EXIT WHEN位置、带参数游标传参类型不匹配、sys_refcursor忘记CLOSE。这些你直接把报错贴给模型对话，它能很快定位。而像「按职位涨薪」这种带IF/ELSIF分支的批量逻辑，用 Coding Plan 让它先出一版结构，你再改，比从零敲快很多。
接入时记住三件套：Base URL + API Key + Model ID。Base URL 用https://taotoken.net/api，Key 用你在 api-keys 页面生成的那串，Model ID 按你选的模型填。这三样配齐，模型对话和 Coding Plan 才能正常工作。下面章节我会给一份可直接复制的配置片段，你照着填就行。
3. 可复制配置：游标模板 + 工具接入 JSON/TOML 片段
这一节分两部分：先给你三套可直接跑的游标代码模板，再给你 TaoToken 在常见工具里的配置片段。代码部分你直接复制到 SQL*Plus 或 IDE 的 SQL 窗口执行即可，配置部分按你的工具选对应的填。
3.1 基础显式游标模板
这是最标准的逐行遍历写法，适合「查出所有行，每行做点事」的场景：
DECLARE -- 声明游标：绑定查询语句 CURSOR emps IS SELECT empno, ename, sal, deptno FROM emp; -- 声明行变量，类型跟随游标结果集 em emps%ROWTYPE; BEGIN OPEN emps; -- 打开游标，此时查询才真正执行 LOOP FETCH emps INTO em; -- 取一行 EXIT WHEN emps%NOTFOUND; -- 取不到就退出 DBMS_OUTPUT.PUT_LINE('姓名:' || em.ename || ' 工资:' || em.sal); END LOOP; CLOSE emps; -- 关闭游标，释放资源 END; /执行前记得在 SQL*Plus 里先开输出：SET SERVEROUTPUT ON;。在 PL/SQL Developer 里则要确保 Output 窗口打开。跑完你应该看到 emp 表里每个员工的姓名和工资逐行打印。
3.2 带参数游标模板
带参数游标的价值在于「一次声明，多次复用不同条件」。声明时在游标名后加参数列表，打开时传值：
DECLARE CURSOR emps(p_dno NUMBER) IS SELECT empno, ename, sal, deptno FROM emp WHERE deptno = p_dno; em emps%ROWTYPE; BEGIN OPEN emps(10); -- 传部门编号 10 LOOP FETCH emps INTO em; EXIT WHEN emps%NOTFOUND; DBMS_OUTPUT.PUT_LINE('姓名:' || em.ename || ' 工资:' || em.sal || ' 部门:' || em.deptno); END LOOP; CLOSE emps; -- 同一个游标，换个参数再开一次 OPEN emps(20); LOOP FETCH emps INTO em; EXIT WHEN emps%NOTFOUND; DBMS_OUTPUT.PUT_LINE('姓名:' || em.ename || ' 工资:' || em.sal || ' 部门:' || em.deptno); END LOOP; CLOSE emps; END; /注意参数类型写NUMBER，传10这种字面量没问题；如果传字符串部门编号，参数类型要对应改成VARCHAR2，否则会报类型转换错误。
3.3 系统引用游标 sys_refcursor
sys_refcursor是 Oracle 内置的弱类型引用游标，特点是「打开时才绑定 SQL」，适合动态查询或把结果集返回给调用方：
DECLARE emps SYS_REFCURSOR; em emp%ROWTYPE; BEGIN OPEN emps FOR SELECT empno, ename, sal, deptno FROM emp; LOOP FETCH emps INTO em; EXIT WHEN emps%NOTFOUND; DBMS_OUTPUT.PUT_LINE('姓名:' || em.ename || ' 工资:' || em.sal); END LOOP; CLOSE emps; END; /这里em用的是emp%ROWTYPE，因为sys_refcursor是弱类型，编译器不知道结果集结构，所以行变量要显式声明成具体表的行类型，且查询列要和表结构对得上。
3.4 TaoToken 工具接入配置片段
如果你用 Cline 或类似支持 MCP 的编辑器插件，配置通常放在 settings JSON 里，路径按你的工具而定，片段如下：
{ "mcpServers": { "taotoken": { "url": "https://taotoken.net/api", "headers": { "Authorization": "Bearer 你的API_KEY" }, "model": "你的Model_ID" } } }如果你用 Codex 这类工具，认证信息常放在auth.json，结构参考：
{ "base_url": "https://taotoken.net/api", "api_key": "你的API_KEY", "model": "你的Model_ID" }用 Claude Code 的话，走 Anthropic 兼容接入，Base URL 同样填https://taotoken.net/api，Key 和 Model ID 按文档填。三件套缺一不可，尤其是 Model ID 填错会直接报模型不存在。
4. 验证请求与成功结果：跑通涨薪案例并确认输出
光看模板不够，得跑一个真实业务逻辑才算验证通过。这一节用「按职位给所有员工涨工资」的案例，把游标遍历和条件更新串起来，并告诉你每一步的预期结果。
需求是这样的：总裁（PRESIDENT）涨 1000，经理（MANAGER）涨 800，其他人涨 400。用显式游标逐行判断职位，再执行对应UPDATE：
DECLARE CURSOR emps IS SELECT empno, ename, job, sal FROM emp; em emps%ROWTYPE; BEGIN OPEN emps; LOOP FETCH emps INTO em; EXIT WHEN emps%NOTFOUND; IF em.job = 'PRESIDENT' THEN UPDATE emp SET sal = sal + 1000 WHERE empno = em.empno; ELSIF em.job = 'MANAGER' THEN UPDATE emp SET sal = sal + 800 WHERE empno = em.empno; ELSE UPDATE emp SET sal = sal + 400 WHERE empno = em.empno; END IF; END LOOP; CLOSE emps; COMMIT; -- 别忘了提交 END; /执行前先记一下基准数据，方便对比：
SELECT empno, ename, job, sal FROM emp ORDER BY empno;跑完上面的 PLSQL 块后，再查一次：
SELECT empno, ename, job, sal FROM emp ORDER BY empno;预期结果是：JOB为PRESIDENT的行SAL增加 1000，MANAGER增加 800，其余增加 400。如果数字对不上，先检查COMMIT有没有执行——没提交的话，你换个会话查还是旧值。
这里有个细节值得说：为什么用游标逐行UPDATE，而不是直接写三条UPDATE ... WHERE job = ...？因为真实业务里每行的调整逻辑往往更复杂，比如还要读另一张表算系数、要写日志、要跳过某些特殊员工。游标给你的是「逐行决策」的能力，这是集合式UPDATE给不了的。当然，如果逻辑真的只是按 job 分三档，直接三条UPDATE性能更好，游标不是万能药，选对场景很重要。
验证sys_refcursor是否正常，可以看它能否被FETCH出数据。如果OPEN ... FOR的 SQL 写错列名，会在OPEN或第一次FETCH时报ORA-00904: invalid identifier，这时候检查列名拼写即可。
5. 本篇常见错排查：从 ORA-01001 到游标不关闭
游标代码的报错其实很集中，我把高频的几个列出来，对照你的实际报错定位。
ORA-01001: invalid cursor。这个通常出现在FETCH或CLOSE一个没OPEN的游标，或者已经CLOSE了又去FETCH。检查你的OPEN和CLOSE是否配对，尤其是有IF分支提前RETURN的情况，可能跳过了CLOSE。
ORA-06550 / PLS-00201: identifier must be declared。多半是游标名或变量名拼错，或者%ROWTYPE写成了别的表。比如em emps%ROWTYPE里emps必须和游标名完全一致，大小写不敏感但拼写要一样。
ORA-01422: exact fetch returns more than requested number of rows。这是用了SELECT INTO而不是游标，结果查出多行。改用显式游标 +LOOP FETCH即可。
ORA-01403: no data found。SELECT INTO查不到数据时抛的，和游标无关，但常被混淆。游标里用%NOTFOUND判断，不会抛这个。
local proxy failed / 401。这两个不是 Oracle 的错，是你接 TaoToken 时遇到的。401说明 API Key 无效或没带Authorization头，检查 Key 是否复制完整、有没有多余空格。local proxy failed通常是 Base URL 填错，确认填的是https://taotoken.net/api，不要多加路径或斜杠。
reading choices 相关报错。这类一般出现在模型返回结构解析失败时，检查你请求的 Model ID 是否存在、请求体格式是否符合文档。对照接入文档里的示例请求体逐字段核对。
OAuth 相关报错。如果你用 Claude Code 走 Anthropic 兼容接入，认证方式要按文档配，别混用 OAuth 和 API Key 两套机制。
游标不关闭导致 ORA-01000: maximum open cursors exceeded。这是最隐蔽的坑。循环里如果每次迭代都OPEN一个游标却不CLOSE，打开数会累积，超过open_cursors参数上限就报错。解决办法：确保每个OPEN都有对应CLOSE，或者用FOR ... IN游标循环（它自动开关）：
BEGIN FOR em IN (SELECT empno, ename, sal FROM emp) LOOP DBMS_OUTPUT.PUT_LINE(em.ename || ':' || em.sal); END LOOP; END; /这种FOR循环写法最省心，不用手动OPEN/FETCH/CLOSE，也不会忘记关闭。缺点是灵活性略低，比如你想在循环中途根据条件重新打开游标就不方便。日常遍历优先用它，复杂控制再用手动四步。
还有一个高频坑：EXIT WHEN写在FETCH之前。这样第一次循环时%NOTFOUND还是初始值，可能直接退出，一行都处理不到。正确顺序永远是「先 FETCH，再判断 EXIT」。
6. 语义一致 CTA：把游标练习和模型辅助串起来
游标这东西，看十遍不如自己敲一遍。建议你按这个顺序练：先把第 3 节的基础模板复制到 SQL*Plus 跑通，确认能看到逐行输出；再把带参数游标改成传不同部门编号，观察结果集变化；最后把涨薪案例完整跑一遍，用前后两次SELECT对比验证。这三步走完，显式游标、参数化游标、sys_refcursor的用法基本就刻进肌肉记忆了。
练习过程中遇到报错，别硬扛。把报错原文和你的代码贴到模型对话里，让它帮你定位，比翻文档快。模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。如果你要写更长的存储过程、批量任务，涉及多游标嵌套和异常处理，可以用 Coding Plan 让它先出结构，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。需要生成或管理 API Key 就去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入细节查文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。
最后留一个实用技巧：写游标时，先在FETCH后加一句DBMS_OUTPUT.PUT_LINE(em.empno)打印主键，确认遍历范围对不对，再写真正的业务逻辑。这个习惯能帮你快速区分「游标没取到数据」和「业务逻辑写错了」两类问题。游标本身不难，难的是把边界情况想全——空结果集、单行、多行、NULL值，这四种情况都测一遍，你的代码就稳了。
