MySQL存储过程异常处理：使用Condition与HANDLER精准捕获错误

核心原理：从错误码到条件名称

MySQL原生错误通常以数字形式呈现（如1062表示重复键）。为了让代码更具可读性，我们可以将具体的SQL错误码映射为语义化的条件名称，然后针对这些名称编写处理逻辑。这种方法比直接判断错误数字更易于维护。

第1步：创建带异常处理的存储过程

以下是包含完整异常处理逻辑的存储过程示例。该过程接收人员信息，尝试查找其主管ID并插入新员工记录，同时处理可能出现的各种数据错误。

DELIMITER $$

CREATE PROCEDURE myProc(
  p_first_name     VARCHAR(30),
  p_last_name      VARCHAR(30),
  p_city           VARCHAR(30),
  p_description    VARCHAR(30),
  OUT p_sqlcode    INT,
  OUT p_status_message VARCHAR(100)
) BEGIN

  /* 1. 声明条件：将SQL错误码映射为易读名称 */
  DECLARE duplicate_key CONDITION FOR 1062;
  DECLARE foreign_key_violated CONDITION FOR 1216;
  DECLARE no_data_found CONDITION FOR NOT FOUND;

  /* 2. 声明局部变量与游标 */
  DECLARE l_manager_id INT;
  DECLARE csr_mgr_id CURSOR FOR
    SELECT id FROM employee
    WHERE first_name = p_first_name AND last_name = p_last_name;

  /* 3. 声明异常处理程序 (Handlers) */
  /* 当发生重复键错误时，设置状态码和消息，继续执行后续逻辑 */
  DECLARE CONTINUE HANDLER FOR duplicate_key
  BEGIN
    SET p_sqlcode = 1052;
    SET p_status_message = 'Duplicate key error';
  END;

  /* 当外键约束违反时 */
  DECLARE CONTINUE HANDLER FOR foreign_key_violated
  BEGIN
    SET p_sqlcode = 1216;
    SET p_status_message = 'Foreign key violated';
  END;

  /* 当游标无法获取数据时（NOT FOUND） */
  DECLARE CONTINUE HANDLER FOR no_data_found
  BEGIN
    SET p_sqlcode = 1329;
    SET p_status_message = 'No record found for manager';
  END;

  /* 4. 业务逻辑执行 */
  SET p_sqlcode = 0;        /* 初始化成功状态 */
  
  OPEN csr_mgr_id;
  FETCH csr_mgr_id INTO l_manager_id;

  /* 检查获取主管ID是否失败 */
  IF p_sqlcode <> 0 THEN
    SET p_status_message = CONCAT(p_status_message, ' when fetching manager id');
  ELSE
    /* 尝试插入新记录 */
    INSERT INTO employee (first_name, id, city)
    VALUES (p_first_name, l_manager_id, p_city);

    /* 如果插入失败（例如主键冲突），p_sqlcode会被Handler修改 */
    IF p_sqlcode <> 0 THEN
      SET p_status_message = CONCAT(p_status_message, ' when inserting new department');
    END IF;
  END IF;

  CLOSE csr_mgr_id;

END$$

DELIMITER ;

第2步：调用存储过程并检查结果

在执行存储过程前，需要初始化用户变量以接收输出结果。调用后，通过查询这些变量来确认操作是成功还是失败了。

-- 初始化接收变量
SET @myCode = 0;
SET @myMessage = '';

-- 调用存储过程
CALL myProc('Jason', 'Martin', 'New City', 'New Description', @myCode, @myMessage);

-- 查看执行结果
SELECT @myCode AS sql_code, @myMessage AS status_msg;

若执行成功，@myCode 将为 0；若触发任何已定义的异常（如插入重复记录），@myCode 将变为对应的非零错误码，且 @myMessage 包含具体的错误描述。

关键细节说明

• DELIMITER $$：由于存储过程内部包含分号，必须临时更改分隔符以避免语句提前截断。
• DECLARE ... CONDITION FOR：这是MySQL 5.x及更早版本的经典写法，用于建立人类可读的错误名称与底层错误码之间的桥梁。
• CONTINUE HANDLER：声明为CONTINUE意味着即使发生错误，存储过程也会继续执行END之前的剩余代码，而不是立即终止。这允许我们进行清理工作（如关闭游标）或返回友好的错误信息。
• DECLARE ORDER：在MySQL中，变量的声明、条件的声明和游标的声明必须在任何逻辑执行语句之前完成，且遵循特定的顺序要求。

以上就是MySQL存储过程异常处理的详细内容，更多关于SQL优化与数据库设计的资料请关注本站其它相关文章！