MySQL存储过程中的变量范围是什么意思？

MySQL存储过程中的变量范围指的是变量在存储过程中可被访问的区域以及变量的生命周期，不同类型的变量生效范围存在明显差异，这是存储过程开发中需要掌握的基础知识点。

MySQL存储过程中常见的变量类型

MySQL存储过程中的变量主要分为三类，分别是局部变量、用户变量和会话变量，三者的定义方式和作用范围各不相同。

1. 局部变量

局部变量是使用DECLARE关键字在存储过程内部定义的变量，它的作用范围仅限于定义它的BEGIN...END代码块内部，超出该代码块就无法访问。

局部变量需要先定义再使用，定义时可以指定默认值，如果没有指定默认值则初始值为NULL。局部变量的生命周期和所在的BEGIN...END代码块一致，代码块执行结束后变量就会被销毁。

下面通过一个简单的存储过程示例说明局部变量的范围：

-- 创建测试存储过程
DELIMITER //
CREATE PROCEDURE test_local_var()
BEGIN
    -- 定义局部变量a，作用范围为当前BEGIN...END块
    DECLARE a INT DEFAULT 10;
    -- 定义内部代码块
    BEGIN
        -- 定义局部变量b，作用范围为内部BEGIN...END块
        DECLARE b INT DEFAULT 20;
        -- 内部块可以访问外部块的变量a，也可以访问自身的变量b
        SELECT a, b;
    END;
    -- 外部块只能访问自身的变量a，无法访问内部块的变量b
    SELECT a;
    -- 下面这行代码会报错，因为b不在当前作用范围
    -- SELECT b;
END //
DELIMITER ;

-- 调用存储过程
CALL test_local_var();

2. 用户变量

用户变量是以@开头的变量，不需要提前声明，直接赋值即可使用。用户变量的作用范围是整个当前数据库连接会话，只要当前连接没有断开，用户变量就会一直存在，并且在当前连接的所有存储过程、SQL语句中都可以访问。

用户变量的生命周期和当前数据库连接会话一致，连接断开后变量会自动销毁。用户变量没有作用域限制，在存储过程内部定义的用户变量，在存储过程外部也可以访问。

以下是用户变量的使用示例：

-- 在存储过程外部定义用户变量
SET @user_var = 100;

-- 创建存储过程访问用户变量
DELIMITER //
CREATE PROCEDURE test_user_var()
BEGIN
    -- 存储过程内部可以访问外部定义的用户变量
    SELECT @user_var;
    -- 存储过程内部修改用户变量
    SET @user_var = 200;
END //
DELIMITER ;

-- 调用存储过程，输出100
CALL test_user_var();
-- 存储过程外部访问修改后的用户变量，输出200
SELECT @user_var;

3. 会话变量

会话变量是MySQL服务器维护的变量，作用范围也是整个当前数据库连接会话，和当前连接的生命周期一致。会话变量分为系统会话变量和用户自定义会话变量，通常我们说的会话变量多指系统提供的会话级配置变量，比如autocommit等。

会话变量可以通过@@前缀访问，修改会话变量只会影响当前连接，不会影响其他连接。

不同变量的范围对比

为了更清晰地展示三类变量的范围差异，我们可以通过下表进行对比：

变量范围相关的注意事项

• 局部变量的名称不要和用户变量、会话变量重名，否则会出现变量值不符合预期的问题，因为MySQL会优先访问作用范围更小的变量。
• 如果需要在多个存储过程之间共享变量值，可以使用用户变量，但要注意用户变量是连接级的，不同连接之间的用户变量互不干扰。
• 局部变量必须定义在存储过程的最开头，也就是BEGIN之后的第一个部分，不能定义在普通SQL语句之后，否则会报语法错误。
• 在存储过程内部，如果需要区分同名的局部变量和用户变量，可以通过@前缀明确指定是用户变量。

下面是一个变量重名场景的示例，帮助理解变量优先级：

DELIMITER //
CREATE PROCEDURE test_var_priority()
BEGIN
    -- 定义局部变量a
    DECLARE a INT DEFAULT 5;
    -- 定义用户变量@a
    SET @a = 10;
    -- 直接访问a，优先访问局部变量，输出5
    SELECT a;
    -- 访问@a，明确指定是用户变量，输出10
    SELECT @a;
END //
DELIMITER ;

CALL test_var_priority();

理解MySQL存储过程中的变量范围，能帮助你更合理地选择变量类型，避免变量冲突和值传递错误，写出逻辑更清晰、稳定性更高的存储过程代码。在实际开发中，建议优先使用局部变量，尽量减少用户变量的使用，这样可以降低变量被意外修改的风险。

MySQL存储过程变量范围局部变量用户变量修改时间：2026-07-07 12:57:30