MySQL存储过程游标使用详解与完整实例

半杯拿铁

发布时间：2026-10-14 | 5人浏览过

原创

在MySQL存储过程中，游标（Cursor）是处理集合数据的关键工具，允许逐行迭代查询结果。本文梳理了从定义到释放的完整操作流程，并通过包含异常处理的实际代码案例，展示如何安全地提取字段值并进行业务逻辑判断。

游标的核心价值与工作流程

当我们需要对数据库查询返回的多行数据进行逐条处理（如计算汇总、记录日志或触发其他逻辑）时，简单的SELECT语句无法满足需求。游标提供了一种“指针”机制，使程序能够控制当前读取的数据行。其工作流遵循严格的顺序：声明 -> 打开 -> 提取(循环) -> 关闭。

准备条件：变量与异常处理声明

在正式操作游标前，必须在存储过程的BEGIN...END块顶部声明必要的局部变量和异常处理器。这是许多初学者容易遗漏的步骤，尤其是用于捕获遍历结束的特定SQL状态码。

第1步：声明控制变量

目的：用于存储FETCH读取到的列值以及判断循环是否终止的状态标志。

动作：使用DECLARE语句定义INT或对应类型的变量，并赋予默认值（通常为NULL或0）。

DECLARE temp_user_id INT DEFAULT NULL;
DECLARE stop_flag INT DEFAULT 0;

第2步：声明游标

目的：将SELECT查询的结果集绑定到一个名称上。

入口：存储过程内部逻辑开始处。

动作：使用DECLARE cursor_name CURSOR FOR SELECT ...语法。注意，此时查询并未执行，仅是定义。

DECLARE temp_cur CURSOR FOR 
SELECT f_user_id FROM table_test WHERE f_user_id = 1;

第3步：声明异常处理器（关键）

目的：当游标尝试读取超出结果集最后一行时，MySQL会抛出NOT FOUND (SQLSTATE '02000')错误。需捕获此状态以退出循环，避免程序崩溃。

动作：使用DECLARE CONTINUE HANDLER FOR NOT FOUND SET variable = 1;。

DECLARE CONTINUE HANDLER FOR NOT FOUND SET stop_flag = 1;

真实操作顺序：执行与循环提取

第4步：打开游标

目的：激活定义的游标，使结果集准备好被读取。

动作：执行OPEN命令。

OPEN temp_cur;

第5步：进入循环并提取数据

目的：逐行获取数据并执行业务逻辑。

重要参数：FETCH INTO 后的变量数量必须与游标SELECT中的列数一致。

WHILE stop_flag <> 1 DO
    -- 第一次通常需单独FETCH或使用REPEAT结构，此处演示WHILE结合预处理逻辑
    -- 实际项目中常先FETCH一次再进循环，或利用REPEAT UNTIL stop_flag=1
    FETCH temp_cur INTO temp_user_id;
    
    IF stop_flag = 1 THEN
        LEAVE my_loop; -- 如果为空直接跳出
    END IF;

    -- 【业务逻辑区】
    -- 在此处根据 temp_user_id 进行INSERT, UPDATE或其他判断
    -- 例如：CALL process_user_data(temp_user_id);
    
END WHILE my_loop;

第6步：关闭游标

目的：释放内存资源，防止连接泄漏。

动作：无论循环正常结束还是发生中断，必须显式CLOSE。

CLOSE temp_cur;

完整综合实例代码

以下是将上述步骤整合在一个存储过程块中的完整示例。该脚本展示了如何声明、处理异常、循环遍历并清理资源。

BEGIN
    DECLARE temp_user_id INT DEFAULT NULL;
    DECLARE stop_flag INT DEFAULT 0;
    
    -- 1. 声明游标
    DECLARE cur_users CURSOR FOR 
        SELECT f_user_id FROM table_test WHERE f_user_id = 1;
        
    -- 2. 声明非正常退出时的handler
    DECLARE CONTINUE HANDLER FOR NOT FOUND SET stop_flag = 1;
    
    -- 3. 打开游标
    OPEN cur_users;
    
    -- 4. 初始提取（针对某些WHILE结构的边界处理，也可调整逻辑结构）
    FETCH cur_users INTO temp_user_id;
    
    WHILE stop_flag <> 1 DO
        -- 【业务处理】
        -- 在此处编写具体逻辑
        
        -- 5. 读取下一行
        FETCH cur_users INTO temp_user_id;
    END WHILE;
    
    -- 6. 关闭游标
    CLOSE cur_users;
END