游标必须配合continue handler for not found使用,否则fetch无数据时抛出not found异常导致存储过程直接中断;正确做法是声明布尔变量(如done)并在handler中设为true,且handler须在open游标前定义。

游标必须配合 CONTINUE HANDLER FOR NOT FOUND 使用,否则会直接报错退出
MySQL 游标没有内置的“是否到末尾”判断机制,FETCH 拿不到数据时默认抛出 NOT FOUND 异常(SQLSTATE '02000'),而存储过程遇到未捕获异常就中断。不声明 handler 就调用 FETCH,第一次没数据就停在那,根本进不了循环。
正确写法是显式绑定一个变量(比如 done)并设为 TRUE:
DECLARE done INT DEFAULT FALSE; DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;
- 变量名任意,但类型必须是
INT或BOOLEAN(MySQL 中FALSE即 0,TRUE即 1) -
NOT FOUND是唯一可靠触发条件;用SQLSTATE '02000'也行,但没必要 - 必须在
OPEN cur之前声明 handler,否则无效
DELETE 语句不能直接写在游标循环里做逐行删除
逐行 DELETE 效率极低,尤其数据量大时:每删一行都走完整事务流程、写 binlog、更新索引,还容易锁表。真正要删几千上万行,应该把 ID 收集起来,最后用一次 IN 或分批 LIMIT 删除。
游标只用来读 ID,别让它干别的:
DECLARE cur CURSOR FOR SELECT id FROM orders WHERE status = 'deleted' LIMIT 1000;
- 游标查询只选主键或唯一索引列,避免
SELECT *拖慢打开速度 -
LIMIT必须加,否则游标一打开就把全量结果集加载进内存 - 真正删除用
DELETE FROM orders WHERE id IN (…)或外部脚本调用DELETE … LIMIT 1000
批量逻辑删除必须手动控制事务边界,不能依赖游标自动提交
MySQL 存储过程中,每个语句默认自动提交(除非显式 START TRANSACTION)。如果游标循环里每删一批就 commit,中间出错没法回滚;全包在一个事务里又可能撑爆 undo log。
稳妥做法是:每处理一批(比如 500 行),显式 COMMIT 一次,并检查影响行数:
SET @batch_ids = '';
-- 循环中拼接 id:CONCAT(@batch_ids, ',', v_id)
-- …
SET @sql = CONCAT('DELETE FROM orders WHERE id IN (', @batch_ids, ')');
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
COMMIT;
- 拼接
IN列表时注意长度限制(max_allowed_packet),超长就拆成多条 - 每次
COMMIT后清空@batch_ids,避免重复删 - 用
ROW_COUNT()判断是否真删了数据,防止空跑
游标无法动态指定表名或字段名,硬编码是唯一安全方式
你不能在 DECLARE CURSOR FOR 里写 SELECT * FROM ? 或拼接表名变量——MySQL 不允许游标使用预编译变量。下面这种写法会直接报错:
SET @table_name = 'orders'; DECLARE cur CURSOR FOR SELECT id FROM @table_name; -- ❌ 语法错误
如果真要通用化,只能靠外部程序生成不同存储过程,或改用事件调度器 + 应用层控制。
- 所有表名、字段名、WHERE 条件都得写死在游标定义里
- 想支持多表?建多个存储过程,别试图用一个过程扛所有逻辑
- 逻辑删除标志字段(如
is_deleted)必须统一命名,否则没法复用
游标本身不难,难的是怎么让它不拖垮数据库。真正上线前,务必用真实数据量压测:看单次循环耗时、binlog 增长速度、以及 SHOW PROCESSLIST 里有没有长时间 Waiting for table metadata 锁。











