1. 存储过程游标 FETCH 变量数不匹配：1328 报错到底在说什么
[Err] 1328 - Incorrect number of FETCH variables是 MySQL 在存储过程里执行FETCH ... INTO ...时抛出的错误，意思是：你声明的游标SELECT出来的列数，和FETCH INTO后面跟的变量个数对不上。它不是什么语法错误，SQL 本身能解析，问题出在运行时——游标打开后，MySQL 拿到结果集的列数，再和你INTO列表里的变量数一比，发现不一致，直接报 1328。
这个报错特别容易出现在两种写法里。第一种是SELECT *，表结构一改（加字段、删字段），游标列数就变了，但FETCH INTO的变量没跟着改。第二种是手写列名时数错了，比如SELECT id, name, age三列，FETCH mc INTO v_id, v_name只写了两个变量。两种情况的本质一样：游标结果集的列数 ≠ FETCH INTO 变量数。
适合谁看？正在写或维护 MySQL 存储过程、被 1328 卡住的开发同学；用 Navicat、DBeaver、命令行mysql客户端跑存储过程报错的运维；以及想搞清楚游标FETCH机制、避免踩坑的后端工程师。这篇会从最小复现脚本开始，一步步定位列数和变量数，给出可复制的修复写法，再用SHOW WARNINGS和逐步SELECT验证结果，最后把常见报错对照着排一遍。
我试过在项目里用游标做批量数据迁移，表结构迭代过几轮，SELECT *的游标就成了定时炸弹，某次上线直接 1328。后来改成显式列名 + 变量对齐，问题才稳定下来。下面按这个思路展开。
2. 复现 1328：最小脚本与游标声明、FETCH INTO 变量对齐
先造两张表，account是源表，account2是目标表。为了让列数差异明显，account放三列，account2也放三列，但游标里故意只FETCH两个变量，触发 1328。
-- 建源表 DROP TABLE IF EXISTS account; CREATE TABLE account ( id INT PRIMARY KEY, iname VARCHAR(15), balance DECIMAL(10,2) ); INSERT INTO account VALUES (1,'Alice',100.00),(2,'Bob',200.00),(3,'Cara',300.00); -- 建目标表 DROP TABLE IF EXISTS account2; CREATE TABLE account2 ( id INT, iname VARCHAR(15), balance DECIMAL(10,2) );现在写一个会报 1328 的存储过程。注意游标SELECT *出来是三列（id、iname、balance），但FETCH mc INTO id, iname只有两个变量。
DROP PROCEDURE IF EXISTS p2_bad; DELIMITER $$ CREATE PROCEDURE p2_bad() BEGIN DECLARE v_id INT; DECLARE v_iname VARCHAR(15); DECLARE flag INT DEFAULT 0; -- 游标：SELECT * 会取到 3 列 DECLARE mc CURSOR FOR SELECT * FROM account; DECLARE CONTINUE HANDLER FOR NOT FOUND SET flag = 1; OPEN mc; l: LOOP -- 这里只写了 2 个变量，列数是 3，必然 1328 FETCH mc INTO v_id, v_iname; IF flag = 1 THEN LEAVE l; END IF; INSERT INTO account2(id, iname) VALUES(v_id, v_iname); END LOOP; CLOSE mc; END$$ DELIMITER ;调用它：
CALL p2_bad();你会看到类似这样的报错：
[Err] 1328 - Incorrect number of FETCH variables关键点在于：游标声明时的SELECT列数，和FETCH INTO的变量数必须严格相等。SELECT *是最危险的写法，因为列数随表结构浮动。修复方向有两个：要么把FETCH INTO补齐到三列，要么把游标SELECT收窄到两列。推荐显式列名，别用*。
先看补齐变量的修法：
DROP PROCEDURE IF EXISTS p2_fix_vars; DELIMITER $$ CREATE PROCEDURE p2_fix_vars() BEGIN DECLARE v_id INT; DECLARE v_iname VARCHAR(15); DECLARE v_balance DECIMAL(10,2); DECLARE flag INT DEFAULT 0; DECLARE mc CURSOR FOR SELECT id, iname, balance FROM account; DECLARE CONTINUE HANDLER FOR NOT FOUND SET flag = 1; OPEN mc; l: LOOP FETCH mc INTO v_id, v_iname, v_balance; IF flag = 1 THEN LEAVE l; END IF; INSERT INTO account2(id, iname, balance) VALUES(v_id, v_iname, v_balance); END LOOP; CLOSE mc; END$$ DELIMITER ;再看收窄游标的修法，只取需要的两列：
DROP PROCEDURE IF EXISTS p2_fix_cols; DELIMITER $$ CREATE PROCEDURE p2_fix_cols() BEGIN DECLARE v_id INT; DECLARE v_iname VARCHAR(15); DECLARE flag INT DEFAULT 0; DECLARE mc CURSOR FOR SELECT id, iname FROM account; DECLARE CONTINUE HANDLER FOR NOT FOUND SET flag = 1; OPEN mc; l: LOOP FETCH mc INTO v_id, v_iname; IF flag = 1 THEN LEAVE l; END IF; INSERT INTO account2(id, iname) VALUES(v_id, v_iname); END LOOP; CLOSE mc; END$$ DELIMITER ;两种都能跑通。区别是：补齐变量适合你确实需要全部列；收窄游标适合只迁移部分字段，性能也更好，因为结果集更小。实际项目里我更倾向显式列名 + 按需取列，避免SELECT *带来的隐式耦合。
这里有个容易忽略的细节：DECLARE的顺序有讲究。MySQL 要求DECLARE变量和条件处理程序（HANDLER）必须写在游标声明之前，游标声明又必须写在HANDLER之前？不对，准确顺序是：变量声明 → 条件声明 → 游标声明 → 处理程序声明。顺序错了会报别的错（比如 1337 或语法错误），不是 1328，但排查时容易混。记住这个顺序能省不少时间。
3. 可复制配置：游标声明、FETCH INTO 与变量对齐模板
把上面的修复整理成一套可复用的模板，直接改表名和列名就能用。核心原则三条：游标SELECT写显式列名；FETCH INTO变量数 = 列数；变量类型和列类型匹配。
DROP PROCEDURE IF EXISTS sp_cursor_template; DELIMITER $$ CREATE PROCEDURE sp_cursor_template() BEGIN -- 1) 变量声明：数量、类型与游标列一一对应 DECLARE v_id INT; DECLARE v_iname VARCHAR(15); DECLARE v_balance DECIMAL(10,2); -- 2) 结束标志 DECLARE done INT DEFAULT 0; -- 3) 游标声明：显式列名，禁止 SELECT * DECLARE cur CURSOR FOR SELECT id, iname, balance FROM account; -- 4) 处理程序：NOT FOUND 时置位 DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = 1; OPEN cur; read_loop: LOOP -- 5) FETCH INTO：变量数必须等于列数（这里是 3） FETCH cur INTO v_id, v_iname, v_balance; IF done = 1 THEN LEAVE read_loop; END IF; -- 6) 业务处理 INSERT INTO account2(id, iname, balance) VALUES(v_id, v_iname, v_balance); END LOOP; CLOSE cur; END$$ DELIMITER ;如果你用 Navicat 或 DBeaver，存储过程体可以直接粘进编辑器，注意DELIMITER在图形客户端里通常不需要，客户端会自己处理分隔符。命令行mysql客户端则必须保留DELIMITER $$，否则分号会提前截断。
再给一个「列数核对」的辅助查询，写游标前先跑一下，确认列数：
-- 查看表的列数和列名，确认游标该写几个变量 SELECT COUNT(*) AS col_count FROM information_schema.columns WHERE table_schema = DATABASE() AND table_name = 'account'; SELECT column_name, data_type FROM information_schema.columns WHERE table_schema = DATABASE() AND table_name = 'account' ORDER BY ordinal_position;col_count是几，FETCH INTO后面就该跟几个变量。这个习惯能提前拦住 1328。
关于工具链，如果你在本地或云端调试存储过程时需要一个稳定的模型接口来辅助生成 SQL 或解释报错，可以走 TaoToken 的 API 接入。它的 Base URL 是https://taotoken.net/api，配合 API Key 和 Model ID 三件套就能在 Cline、Codex 这类工具里用起来。具体配置片段如下（以 Cline MCP 风格的 JSON 为例）：
{ "mcpServers": { "taotoken": { "url": "https://taotoken.net/api", "headers": { "Authorization": "Bearer YOUR_API_KEY" }, "model": "YOUR_MODEL_ID" } } }如果你用的是 Codex 的auth.json，结构类似：
{ "base_url": "https://taotoken.net/api", "api_key": "YOUR_API_KEY", "model": "YOUR_MODEL_ID" }三件套缺一不可：Base URL 指向https://taotoken.net/api，Key 换成你自己的，Model ID 填你选用的模型。配置好后让模型帮你审游标代码，它能快速指出FETCH INTO变量数和列数是否一致。需要 Key 的话去控制台生成，文档在接入文档里，模型对话入口可以直接试。
4. 验证请求与成功结果：SHOW WARNINGS 与逐步 SELECT
修完别急着说「好了」，要验证。第一步，调用修复后的过程：
CALL sp_cursor_template();如果没报错，说明列数和变量数对上了。接着查目标表：
SELECT * FROM account2;预期结果：
+----+-------+---------+ | id | iname | balance | +----+-------+---------+ | 1 | Alice | 100.00 | | 2 | Bob | 200.00 | | 3 | Cara | 300.00 | +----+-------+---------+三行都迁过来了，说明游标循环正常，NOT FOUND处理程序也在最后一次FETCH后正确退出。
第二步，用SHOW WARNINGS看有没有隐藏警告。有些问题不会直接报错，但会进 warning 列表：
SHOW WARNINGS;如果返回空，说明干净。如果有内容，逐条看，常见的是数据截断（比如VARCHAR长度不够）或类型转换警告，这些和 1328 无关，但顺手排掉。
第三步，逐步SELECT验证游标逻辑。把游标里的SELECT单独拎出来跑：
SELECT id, iname, balance FROM account;数一下返回几列，和FETCH INTO的变量数对一遍。这是最直接的核对方式。你也可以在存储过程里临时加SELECT打印变量，确认每次FETCH取到的值：
-- 调试用：在 LOOP 里加一行 SELECT v_id, v_iname, v_balance;跑完记得删掉调试语句，别留在生产过程里。
第四步，验证边界情况。空表会不会死循环？把account清空再调一次：
TRUNCATE TABLE account; CALL sp_cursor_template(); SELECT COUNT(*) FROM account2;结果是 0，且过程正常结束，说明NOT FOUND处理程序在第一次FETCH就置位并LEAVE，没有死循环。这一步很多人忽略，但空表 + 游标是经典死循环场景，值得测。
如果你在验证时想用模型对话快速解释SHOW WARNINGS的输出，或者让它帮你比对列数和变量数，走模型对话入口就行，把报错和代码贴进去，让它逐行核对。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth 对照
1328 本身是列数/变量数问题，但排查过程中常混进别的报错。下面按真实遇到的报错对照着排。
1328 反复出现：先确认游标SELECT是不是*。是的话改成显式列名。再数FETCH INTO变量数，用第 3 节的information_schema查询核对列数。还有一种隐蔽情况：游标SELECT里用了JOIN，列数 = 所有参与表的列数之和，容易数漏。把JOIN的SELECT单独跑一遍，看返回几列。
401 Unauthorized：这通常出现在你调外部 API 辅助排查时，比如用 Cline 或 Codex 连模型接口。检查Authorization头里的 Key 是否正确、有没有过期、有没有多余空格。Base URL 要写https://taotoken.net/api，别拼错路径。Key 去控制台重新生成一个再试。
local proxy failed：本地代理配置问题。如果你在工具里填了代理地址但服务没起来，就会报这个。检查代理进程是否运行、端口是否被占用。注意这里说的是工具自身的网络配置，不是让你去搞什么网络加速，纯粹是本地服务连通性排查。把代理配置清空，直连https://taotoken.net/api试试。
reading choices 相关报错：这类报错一般出现在解析模型返回结构时，比如返回体里choices字段为空或格式不对。先确认 Model ID 填对了，不同模型的返回结构可能不同。再看请求体是不是合法 JSON，messages数组有没有写错。把请求原样贴到模型对话里，让它帮你看结构。
OAuth 报错：如果你用 Claude Code 或类似工具走 OAuth 流程，报错通常是回调地址不匹配或 token 过期。检查回调 URL 是否和配置一致，重新走一遍授权。OAuth 和 API Key 是两套机制，别混用。
Codex auth.json 配置后仍 401：三件套核对——base_url是不是https://taotoken.net/api，api_key有没有引号包裹错误，model是不是有效 ID。JSON 里不能有注释，不能有多余逗号。改完重启工具。
Cline MCP 连不上：检查mcpServers的 JSON 结构，url和headers层级对不对。MCP 配置对缩进敏感，建议用格式化工具过一遍。连上后如果模型不响应，换一个 Model ID 试。
CC Switch 切换后报错：确认切换的目标配置里 Base URL、Key、Model ID 三件套完整。切换不会自动补全缺失字段，缺一个就连不上。
把 1328 和这些网络/鉴权报错分开看：1328 是 SQL 层面的，改代码；401、proxy、OAuth 是接入层面的，改配置。两者混在一起排查会绕远路。
6. 从 1328 到稳定游标：接入与排障的顺手路径
游标 1328 的根因就一句话：列数和变量数不等。修法也就两条路：补齐变量，或收窄列。真正省事的是养成习惯——游标SELECT永远写显式列名，FETCH INTO写完立刻数一遍，表结构变更时同步改游标。这三条做到，1328 基本不会再来。
如果你在写复杂存储过程时需要模型帮你审代码、解释报错、生成对齐模板，可以走 TaoToken 的接入。API Key 在 API Keys 页面生成，接入文档里有各工具的配置示例，模型对话入口可以直接贴代码试。长期做编码和 Agent 类任务的话，Coding Plan 更适合持续用。
最后留一个实用技巧：把第 3 节的information_schema列数查询存成片段，每次写游标前跑一下，比事后排 1328 省时间。存储过程调试本来就烦，能提前拦住的错就别让它跑到运行时。
