在MySQL数据库管理中，变量、游标是处理复杂逻辑的重要工具，但若使用不当，常会导致报错影响执行效率，合理掌握其语法规则与避坑技巧，能显著提升存储过程、函数等数据库对象的开发质量，以下从变量定义与作用域、游标操作流程、常见报错场景及解决方案三方面展开分析,帮助开发者规避开发陷阱。
MySQL变量的定义与作用域
MySQL变量分为会话变量、局部变量和全局变量三类，其作用域与声明方式直接关联，混淆这三者往往导致“变量未定义”或“权限不足”等报错。
会话变量与全局变量的声明
会话变量（以开头）作用于当前连接会话，声明时可使用SET或SELECT赋值，
SET @session_var = 100; SELECT @global_var := COUNT(*) FROM users;
需注意，全局变量（需SUPER权限）通过SET GLOBAL修改，仅对后续连接生效，当前会话需手动刷新：
SET GLOBAL max_connections = 1000; SET @@global.max_connections = 1000; -- 等价写法
局部变量的作用域限制
局部变量声明于存储过程、函数或触发器内，使用DECLARE关键字，且必须位于复合语句（BEGIN...END）开头，其他变量声明之前，其作用域仅限当前BEGIN...END块，
BEGIN
DECLARE local_var INT DEFAULT 0;
SELECT COUNT(*) INTO local_var FROM orders WHERE status = 'pending';
-- local_var 仅在此处有效
END;
若局部变量与会话变量同名，局部变量优先级更高，但建议通过命名规范（如var_前缀）避免混淆。
游标的基本操作与注意事项
游标用于逐行查询结果集，适合需对单条数据处理的复杂场景，但操作不当易引发“游标未声明”或“数据不一致”等报错，其核心流程包含声明、打开、提取与关闭四步。
游标声明与结果集绑定
游标声明需基于SELECT语句，且结果集字段需与提取变量一一对应。
DECLARE cur_orders CURSOR FOR SELECT id, user_id FROM orders WHERE create_time > '2025-01-01';
需注意：游标声明需在变量之后、处理逻辑之前，且SELECT语句不能包含INTO子句（结果集直接绑定到游标）。
游标打开与数据提取
打开游标后，通过FETCH ... INTO提取数据到局部变量，循环处理完成后需关闭游标并释放资源：
OPEN cur_orders;
read_loop: LOOP
FETCH cur_orders INTO order_id, user_id;
IF done THEN
LEAVE read_loop;
END IF;
-- 处理逻辑，如更新用户状态
UPDATE users SET last_order_id = order_id WHERE id = user_id;
END LOOP;
CLOSE cur_orders;
关键点：需提前定义DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = 1;捕获结果集结束信号，否则FETCH后无数据时会报“1329 - No data to fetch”错误。
游标使用的限制
- 游标不能用于存储函数（仅允许在存储过程、触发器中使用）；
- 游标操作时，当前事务会锁定相关表，长时间游标可能导致锁等待超时；
- 嵌套游标需确保内层游标完全关闭后再操作外层游标，否则引发“游标已打开”报错。
常见报错场景与解决方案
变量报错：“Variable 'xxx' is not defined”
原因：局部变量未在BEGIN...END开头声明，或会话变量未初始化。
解决：检查局部变量声明位置是否正确，会话变量使用前通过SET或SELECT赋值，避免直接引用未定义变量。
游标报错：“Cursor is already open”
原因：重复打开未关闭的游标，或嵌套游标时内层游标未关闭。
解决：确保每次打开游标前先关闭，或使用DECLARE CONTINUE HANDLER FOR SQLEXCEPTION捕获异常后统一关闭游标。
游标报错：“Cursor not open”
原因：未打开游标直接执行FETCH，或游标已关闭后再次操作。
解决：严格按“声明→打开→提取→关闭”流程操作，使用IF CURSOR_NAME IS NOT NULL判断游标状态。
事务与游标冲突：“Lock wait timeout exceeded”
原因：游标所在事务未及时提交，导致长时间锁定表资源。
解决：在游标循环内适当提交事务（如每处理100条提交一次），或减少游标操作的数据量。
相关问答FAQs
Q1: 为什么在存储过程中使用局部变量时，提示“Variable 'var_name' is not declared”？
A: 局部变量必须在BEGIN...END复合语句的开头声明，且需在 DECLARE CONTINUE HANDLER、游标或其他变量之前，以下写法会报错：
BEGIN
SET @var = 1; -- 错误：局部变量声明前不能有其他语句
DECLARE local_var INT DEFAULT 0;
END;
正确做法是将局部变量声明移至最前：
BEGIN
DECLARE local_var INT DEFAULT 0;
SET @var = 1;
END;
Q2: 游标循环中如何避免“1329 - No data to fetch”错误？
A: 需通过DECLARE CONTINUE HANDLER捕获结果集结束信号，并设置结束标志变量，完整示例如下：
DECLARE done INT DEFAULT FALSE;
DECLARE cur_orders CURSOR FOR SELECT id FROM orders;
DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;
OPEN cur_orders;
read_loop: LOOP
FETCH cur_orders INTO order_id;
IF done THEN
LEAVE read_loop;
END IF;
-- 处理逻辑
END LOOP;
CLOSE cur_orders;
通过done变量判断是否到达结果集末尾，避免无数据时继续FETCH导致报错。