1. 为什么你写的游标总是报错：从一次存储过程排障说起
SQL Server 游标 cursor 是一套让结果集“逐行走”的语法机制，适合在存储过程或脚本里做逐行加工、跨表拼接、调用函数写回临时表这类集合操作不好表达的场景。它适合两类人：一类是维护老库、老存储过程的 DBA，另一类是要在 T-SQL 里做行级计算的 后端开发者。很多人第一次写游标，卡点不在逻辑，而在生命周期：DECLARE 声明了却没 OPEN，OPEN 了却忘了 CLOSE，循环里 @@FETCH_STATUS 判断写反，最后 DEALLOCATE 漏掉，连接池里游标句柄越积越多。
我见过最典型的报错是 “A cursor with the name 'C_pro' already exists.” 和 “The cursor is not open.”。前者说明上一次执行没释放，后者说明 FETCH 之前没 OPEN。这两个错误几乎覆盖了初学者 80% 的游标问题。所以这篇不讲抽象概念，直接把 DECLARE、OPEN、FETCH、CLOSE、DEALLOCATE 五个阶段的配置骨架摊开，再给你 @@FETCH_STATUS 的验证动作和资源释放检查，照着改就能跑。
需要说明的是，游标本身是 SQL Server 原生语法，和任何第三方服务无关。但如果你在写 T-SQL 的同时还要接大模型做代码补全、SQL 审查或 Agent 自动化，下面会顺带说一个接入层的配置方式，纯属工具链补充，不影响游标本身的语法学习。
2. 前置准备：环境、权限与接入层配置
2.1 SQL Server 侧的最小条件
你只需要一个能连上的 SQL Server 实例（2016 及以上都行，语法一致），以及一张有数据的表。权限上，执行游标需要对该表有 SELECT 权限，如果游标里要 UPDATE 还需要对应写权限。数据库兼容级别建议 130 以上，避免老版本游标语义差异。
验证连接是否正常，可以先跑一句：
SELECT @@VERSION AS ver, DB_NAME() AS db;能返回版本号和当前库名，说明基础环境没问题。
2.2 接入层：用 TaoToken 统一管理模型调用
如果你的工作流里除了写 SQL，还要让模型帮你审游标逻辑、生成测试数据或做代码解释，可以把模型调用统一到一个入口。TaoToken 的 API 地址是 https://taotoken.net/api ，控制台在 https://taotoken.net/console ，API Keys 管理页在 https://taotoken.net/api-keys 。模型对话入口在 https://taotoken.net/model-chat ，接入文档在 https://taotoken.net/doc 。
这套东西和游标语法没有耦合，它只是让你在写 T-SQL 时有个稳定的模型侧辅助。真正要跑游标，还是回到 SSMS 或 sqlcmd。
2.3 准备一张测试表
为了让后面的骨架能直接复制运行，先建一张小表：
IF OBJECT_ID('dbo.Authors','U') IS NOT NULL DROP TABLE dbo.Authors; CREATE TABLE dbo.Authors( au_id VARCHAR(11) PRIMARY KEY, au_fname VARCHAR(20), au_lname VARCHAR(20), state CHAR(2) ); INSERT INTO dbo.Authors VALUES ('A001','John','Smith','UT'), ('A002','Jane','Doe','CA'), ('A003','Mike','Brown','UT');三行数据足够验证游标循环取数是否正确。
3. 可复制配置：游标五阶段完整骨架
3.1 DECLARE：声明游标与变量
声明阶段要做两件事：定义游标名和结果集，定义接收列值的变量。变量类型必须和 SELECT 出来的列类型兼容，否则 FETCH 会报类型转换错误。
DECLARE @au_id VARCHAR(11); DECLARE @au_fname VARCHAR(20); DECLARE @au_lname VARCHAR(20); DECLARE C_pro CURSOR FOR SELECT au_id, au_fname, au_lname FROM dbo.Authors WHERE state = 'UT' ORDER BY au_id;这里 C_pro 是游标名，SELECT 的列顺序必须和后面 FETCH INTO 的变量顺序一一对应。顺序错了不会报错，但值会串位，这是最隐蔽的坑。
3.2 OPEN：打开游标
OPEN C_pro;OPEN 之后，游标指针停在第一行之前。此时可以用@@CURSOR_ROWS看结果集行数（注意它可能返回 -1，表示异步填充，属正常现象）。
3.3 FETCH 与 WHILE：循环取数骨架
标准写法是先 FETCH 一次，再进 WHILE 判断 @@FETCH_STATUS。
FETCH NEXT FROM C_pro INTO @au_id, @au_fname, @au_lname; WHILE @@FETCH_STATUS = 0 BEGIN -- 逐行处理逻辑，例如写入临时表 PRINT @au_id + ' | ' + @au_fname + ' | ' + @au_lname; FETCH NEXT FROM C_pro INTO @au_id, @au_fname, @au_lname; END@@FETCH_STATUS 的取值含义要记牢：0 表示 FETCH 成功；-1 表示 FETCH 失败或超出结果集；-2 表示被提取的行已不存在（比如被其他连接删了）。循环条件写= 0是唯一正确姿势，写成<> -1在某些边界下会多跑一次。
3.4 CLOSE 与 DEALLOCATE：释放资源
CLOSE C_pro; DEALLOCATE C_pro;CLOSE 释放结果集和锁，但游标结构还在，可以再次 OPEN。DEALLOCATE 彻底删除游标定义，释放句柄。两者顺序不能反，先 DEALLOCATE 再 CLOSE 会报 “The cursor is not open.”。
3.5 完整可运行脚本
把上面拼起来，加上错误处理，就是一份可直接复制的骨架：
SET NOCOUNT ON; DECLARE @au_id VARCHAR(11); DECLARE @au_fname VARCHAR(20); DECLARE @au_lname VARCHAR(20); DECLARE C_pro CURSOR FOR SELECT au_id, au_fname, au_lname FROM dbo.Authors WHERE state = 'UT' ORDER BY au_id; OPEN C_pro; FETCH NEXT FROM C_pro INTO @au_id, @au_fname, @au_lname; WHILE @@FETCH_STATUS = 0 BEGIN PRINT @au_id + ' | ' + @au_fname + ' | ' + @au_lname; FETCH NEXT FROM C_pro INTO @au_id, @au_fname, @au_lname; END CLOSE C_pro; DEALLOCATE C_pro; GO执行后应输出两行 UT 作者记录。如果输出为空，先检查 WHERE 条件，再检查表里是否真有 state='UT' 的数据。
4. 验证请求与成功结果：@@FETCH_STATUS 检查动作
4.1 循环内打印状态
在循环里加一句状态输出，能直观看到每次 FETCH 的结果：
WHILE @@FETCH_STATUS = 0 BEGIN PRINT 'status=' + CAST(@@FETCH_STATUS AS VARCHAR(2)) + ' id=' + @au_id; FETCH NEXT FROM C_pro INTO @au_id, @au_fname, @au_lname; END PRINT 'loop end status=' + CAST(@@FETCH_STATUS AS VARCHAR(2));正常情况：循环内每次 status=0，循环结束后 status=-1。如果循环内出现 -1，说明 FETCH 提前失败，通常是变量类型不匹配或结果集被并发修改。
4.2 用 @@CURSOR_ROWS 核对行数
OPEN C_pro; SELECT @@CURSOR_ROWS AS rows_in_cursor;返回 2 表示结果集两行。如果返回 -1，说明游标是异步填充的，可以加STATIC关键字强制静态游标：
DECLARE C_pro CURSOR STATIC FOR SELECT au_id, au_fname, au_lname FROM dbo.Authors WHERE state = 'UT';静态游标会把结果集复制到 tempdb，行数稳定，代价是内存和 IO 开销略高。
4.3 资源释放检查
执行完 DEALLOCATE 后，用系统视图确认没有残留：
SELECT name, creation_time FROM sys.dm_exec_cursors(0) WHERE name = 'C_pro';返回空结果集，说明游标已彻底释放。如果还有记录，检查是不是漏了 DEALLOCATE，或者脚本中途 RETURN 跳过了释放段。
5. 本篇常见错排查
5.1 “A cursor with the name 'C_pro' already exists.”
原因：同名游标未释放就重复 DECLARE。解决：在 DECLARE 前加防御性释放，或者用局部游标变量。
IF CURSOR_STATUS('global','C_pro') >= 0 BEGIN CLOSE C_pro; DEALLOCATE C_pro; END更推荐用DECLARE @cur CURSOR局部变量写法，作用域随批处理结束自动清理：
DECLARE @cur CURSOR; SET @cur = CURSOR FOR SELECT au_id FROM dbo.Authors WHERE state = 'UT'; OPEN @cur; -- ... FETCH ... CLOSE @cur; DEALLOCATE @cur;5.2 “The cursor is not open.”
原因：FETCH 或 CLOSE 之前没 OPEN，或者已经 DEALLOCATE 了还在操作。解决：按 DECLARE → OPEN → FETCH → CLOSE → DEALLOCATE 顺序检查，别跳步。
5.3 FETCH 成功但变量是 NULL
原因：SELECT 列里有 NULL 值，或者变量类型和列类型不兼容导致隐式转换失败。解决：用ISNULL(col, '')兜底，或者核对变量声明类型。
5.4 循环多跑一次或少跑一次
原因：@@FETCH_STATUS 判断条件写错，或者 FETCH 位置放错。解决：严格用“先 FETCH 一次，WHILE = 0，循环体末尾再 FETCH”的结构，不要用 DO-WHILE 思路。
5.5 游标里 UPDATE 导致死锁
原因：默认游标是动态的，持有共享锁，循环内 UPDATE 同一张表容易升级为死锁。解决：改用STATIC或FAST_FORWARD游标，或者把要更新的主键先收集到临时表，循环外批量更新。
DECLARE C_pro CURSOR FAST_FORWARD FOR SELECT au_id FROM dbo.Authors WHERE state = 'UT';FAST_FORWARD 是只进只读游标，性能最好，适合纯读取场景。
6. 语义一致收尾：把游标骨架用起来
游标不是洪水猛兽，也不是首选方案。能用集合操作（UPDATE ... FROM、MERGE、窗口函数）解决的，优先用集合操作。只有当逻辑确实需要逐行、需要调用标量函数、需要跨行状态累积时，再上游标。用的时候记住五阶段顺序和 @@FETCH_STATUS = 0 这个唯一正确判断，基本不会翻车。
如果你在写游标的同时想让模型帮你审逻辑、生成边界测试数据，可以在 https://taotoken.net/api-keys 拿一个 Key，接入文档在 https://taotoken.net/doc ，模型对话在 https://taotoken.net/model-chat 。长期做编码和 Agent 自动化的，可以看 https://taotoken.net/coding-plan 。这些只是工具链补充，游标本身的语法和验证动作，以上面五阶段骨架为准。
