MySQL存储过程异常处理实战：捕获错误与事务回滚

宋时安

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

原创

在MySQL开发中，存储过程若遇到主键冲突或执行错误默认会中止并抛出异常。通过配置 DECLARE HANDLER，可以拦截 SQLSTATE、SQLWARNING 或 SQLEXCEPTION，实现自定义的错误码返回或自动 ROLLBACK 事务，从而保障业务逻辑的稳健性。

基础异常处理原理

MySQL 支持通过 CONTINUE 或 EXIT 声明的 HANDLER 来捕获异常。常见的异常条件包括：

SQLWARNING：捕获所有警告。
NOT FOUND：捕获没有找到数据的情况（例如 SQLCODE = 1329）。
SQLEXCEPTION：捕获所有其他非警告类异常。

如果不进行异常处理，当语句出错时（如违反约束），存储过程将直接终止并向上层应用抛出 ERROR。例如，以下代码因插入重复记录而报错：

CREATE PROCEDURE test_proc_ins1(
     IN i_id INT,
     IN i_name VARCHAR(100)
)
BEGIN
     INSERT INTO testproc VALUES (i_id,i_name);
     INSERT INTO testproc VALUES (i_id,i_name);
END;

第一步：使用 EXIT HANDLER 自定义返回码

目的：捕获特定错误，不向调用方抛出异常，而是通过 OUT 参数返回状态码（如 -1 表示失败，1 表示成功）。

操作要点：在 BEGIN ... END 块内部使用 DECLARE EXIT HANDLER FOR SQLSTATE '...' SET var = value;。

CREATE PROCEDURE test_proc_ins1(
     IN i_id INT,
     IN i_name VARCHAR(100),
     OUT o_ret INT
)
BEGIN
     -- 声明退出处理器：当发生 SQLSTATE '23000' (主键/唯一索引冲突) 时
     -- 将 o_ret 设为 -1 并立即退出当前流程
     DECLARE EXIT HANDLER FOR SQLSTATE '23000' 
         SET o_ret = -1;
         
     INSERT INTO testproc VALUES (i_id,i_name);
     INSERT INTO testproc VALUES (i_id,i_name);-- 此行大概率触发 23000 错误
     
     -- 若无错误执行到此，设置成功标识
     SET o_ret = 1;
END;

这样在 Java 或其他调用环境中，即可检查 o_ret 的值而非捕获数据库异常。

第二步：在异常触发时执行 ROLLBACK 撤销事务

目的：当部分操作已执行但随后出错时，自动回滚整个事务以保持数据一致性。

注意：涉及删除、覆盖或清空数据时需谨慎确认备份策略，回滚仅适用于未提交的事务。

操作要点：结合 START TRANSACTION 和 DECLARE HANDLER，在 SQLEXCEPTION 或 SQLWARNING 触发时执行 ROLLBACK。

DELIMITER //

CREATE PROCEDURE TEST()
BEGIN
    -- 定义异常处理器：发生任何 SQL 错误或警告或无数据时
    DECLARE EXIT HANDLER FOR SQLEXCEPTION, SQLWARNING, NOT FOUND
    BEGIN
        -- 回滚事务
        ROLLBACK;
        -- 可选：插入日志记录错误
        INSERT INTO bb VALUES('error');
    END;

    -- 开启事务
    START TRANSACTION;
    
    INSERT INTO aa VALUES (1);
    INSERT INTO aa VALUES (2);
    
    COMMIT;
END;//