MySQL DECLARE HANDLER 怎样只处理 NOT FOUND 条件

在 MySQL 存储过程中，想“只处理”NOT FOUND，通常不是把所有错误吞掉，而是声明一个明确的 CONTINUE HANDLER，只接收 SQLSTATE 02 类条件，再用状态变量决定是否离开当前循环。游标读到末尾时会产生 02000；SELECT ... INTO 没有返回行时，也可能触发同一类条件。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/declare-handler.html

先区分 NOT FOUND 与普通异常

NOT FOUND 是条件类，不等于“所有查询失败”。MySQL 把 SQLSTATE 以 02 开头的条件归到这一类，最常见的是游标已经没有下一行，或者 SELECT ... INTO 没有查到行。它适合表示“没有更多数据”，不适合替代对语法错误、权限错误和重复键错误的处理。

因此，标题中的“只处理”有两个含义：handler 的匹配条件只写 NOT FOUND，业务动作只设置一个结束标记。其它异常仍然按它们自己的 handler 规则处理，不要用空的通用 SQLEXCEPTION 把问题隐藏掉。

-- 只演示条件匹配，不把其它异常混进来
DECLARE CONTINUE HANDLER FOR NOT FOUND
    SET done = 1;

按顺序声明变量、游标和 handler

MySQL 的存储程序声明区有固定顺序。先声明局部变量，再声明游标，最后声明 handler。把 handler 写到游标前面，容易遇到“游标声明位于 handler 之后”的定义错误；把局部变量写到 handler 后面，也会破坏声明规则。

-- 先放状态变量，用来保存“已经读完”的信号
DECLARE done TINYINT DEFAULT 0;
DECLARE current_id BIGINT;
DECLARE current_name VARCHAR(80);

-- 游标声明必须位于 handler 声明之前
DECLARE item_cursor CURSOR FOR
    SELECT id, name FROM demo_items ORDER BY id;

-- 只把没有下一行当作可控结束条件
DECLARE CONTINUE HANDLER FOR NOT FOUND
    SET done = 1;

这里的 done 是普通局部变量，不是 MySQL 的特殊关键字。用整数或布尔语义都可以，关键是默认值必须表示“尚未结束”，并且每次调用过程时都从初始值开始。

用 CONTINUE HANDLER 结束游标循环

游标循环的关键顺序是“先 FETCH，再检查 done，最后才使用当前行”。因为读到末尾时，FETCH 会触发 handler；如果在检查标记前就处理变量，代码可能把上一次循环残留的值误当成新行。

-- 示例过程：把游标读到的名称复制到结果表
CREATE PROCEDURE copy_item_names()
BEGIN
    -- 声明区必须遵守变量、游标、handler 的先后顺序
    DECLARE done TINYINT DEFAULT 0;
    DECLARE current_id BIGINT;
    DECLARE current_name VARCHAR(80);
    DECLARE item_cursor CURSOR FOR
        SELECT id, name FROM demo_items ORDER BY id;

    -- FETCH 读完时设置结束标记，当前块继续执行到 IF
    DECLARE CONTINUE HANDLER FOR NOT FOUND
        SET done = 1;

    OPEN item_cursor;

    read_loop: LOOP
        -- 读下一行；没有下一行时会触发上面的 handler
        FETCH item_cursor INTO current_id, current_name;

        -- 先判断是否读完，再使用本轮数据
        IF done = 1 THEN
            LEAVE read_loop;
        END IF;

        -- 只有确认 FETCH 成功后才写入目标表
        INSERT INTO demo_item_names (item_id, item_name)
        VALUES (current_id, current_name);
    END LOOP;

    -- 循环结束后关闭游标，释放本过程的游标资源
    CLOSE item_cursor;
END;

选择 CONTINUE 的原因，是让控制权回到当前复合语句，随后由 IF done = 1 执行 LEAVE。如果改成 EXIT，handler 执行后会直接离开声明它的 BEGIN ... END 块，通常就没有机会按这套循环逻辑完成收尾。

用嵌套块隔离 SELECT ... INTO

同一个作用域里，另一个 FETCH 或 SELECT ... INTO 也可能触发 NOT FOUND。这会让外层的 done 被提前设置，表现为游标还没读完却退出循环。需要把两种来源分开时，可以在局部 BEGIN ... END 中声明自己的 handler 和标记。

-- 外层负责游标结束，内层负责“查不到详情”的业务分支
CREATE PROCEDURE read_items_with_detail()
BEGIN
    -- 外层状态只代表游标是否还有下一行
    DECLARE cursor_done TINYINT DEFAULT 0;
    DECLARE current_id BIGINT;
    DECLARE detail_text VARCHAR(255);
    DECLARE item_cursor CURSOR FOR
        SELECT id FROM demo_items ORDER BY id;

    -- 外层 handler 只监听游标 FETCH 的结束
    DECLARE CONTINUE HANDLER FOR NOT FOUND
        SET cursor_done = 1;

    OPEN item_cursor;
    read_loop: LOOP
        FETCH item_cursor INTO current_id;
        IF cursor_done = 1 THEN
            LEAVE read_loop;
        END IF;

        -- 局部块把 SELECT ... INTO 的“无结果”单独处理
        BEGIN
            DECLARE detail_missing TINYINT DEFAULT 0;

            DECLARE CONTINUE HANDLER FOR NOT FOUND
                SET detail_missing = 1;

            SELECT description
              INTO detail_text
              FROM demo_item_details
             WHERE item_id = current_id;

            IF detail_missing = 1 THEN
                SET detail_text = '暂无详情';
            END IF;
        END;

        -- 这里拿到的是当前行对应的详情或兜底文本
        INSERT INTO demo_item_results (item_id, detail_text)
        VALUES (current_id, detail_text);
    END LOOP;
    CLOSE item_cursor;
END;

内层 handler 声明在内层块中，所以它优先负责内层 SELECT ... INTO 的无结果情况；外层 handler 仍只负责外层游标。这个写法的重点是缩小条件来源，不是让每一条 SQL 都重复声明 handler。

五个容易把 NOT FOUND 用错的边界

相关问题

NOT FOUND 只能用于游标吗？

不能。游标没有更多行时会触发它，SELECT ... INTO 没有返回行时也可能触发同一条件。若两类语句同时存在，应通过嵌套块或不同状态变量区分来源。

为什么不用 SQLEXCEPTION 统一处理？

SQLEXCEPTION 覆盖的是更广的异常类，会把权限、语法或数据约束问题和“没有下一行”混在一起。游标结束属于正常控制分支，单独使用 NOT FOUND 更容易排查。

CONTINUE handler 会不会自动跳过当前循环？

它只决定 handler 执行后继续当前程序块，是否离开循环仍由你的 IF、LEAVE 或其它控制语句决定。常见做法是设置 done，再显式离开循环。