mysql执行SQL时如何检测和处理错误_mysql错误处理机制

来源：这里教程网时间：2026-02-28 20:51:22 作者：

MySQL客户端执行SQL出错时，错误信息从哪来

MySQL客户端（如 mysql 命令行、Python的

pymysql

、PHP的

mysqli

）执行SQL失败时，错误不是由SQL本身“吐出来”的，而是服务端返回的协议包里带的错误码和消息。客户端收到后才抛异常或设错误标志。

这意味着：不主动检查返回值或捕获异常，错误就静默吞掉了。

mysql
命令行默认开启
--force
以外的行为：遇到错误直接停止后续语句（除非用
source
批量执行且加了
--force
）在存储过程中用
INSERT INTO ... SELECT
出错，默认中断整个过程，除非定义了
DECLARE ... HANDLER
应用层如 Node.js 的
mysql2
，必须监听
error
事件或用
try/catch
包裹
await query()

如何在存储过程中捕获并处理错误

MySQL 5.5+ 支持基于 SQLSTATE 或 MySQL 错误码的异常处理机制，核心是

DECLARE ... HANDLER

，但仅限于存储过程、函数、触发器内使用，不能用于普通交互式SQL。

常见写法：

DROP PROCEDURE IF EXISTS safe_insert;
DELIMITER $$
CREATE PROCEDURE safe_insert(IN p_id INT)
BEGIN
  DECLARE EXIT HANDLER FOR SQLEXCEPTION
  BEGIN
    ROLLBACK;
    SELECT '发生未知错误，已回滚' AS msg;
  END;
<p>DECLARE EXIT HANDLER FOR SQLSTATE '23000' -- 如主键冲突、唯一索引冲突
BEGIN
ROLLBACK;
SELECT '主键/唯一约束冲突' AS msg;
END;</p><p>START TRANSACTION;
INSERT INTO users(id, name) VALUES(p_id, 'test');
COMMIT;
END$$
DELIMITER ;

SQLSTATE '23000'
覆盖大部分完整性约束错误；具体可查 MySQL 官方错误码表
EXIT HANDLER
触发后自动退出当前作用域（即过程体），
CONTINUE HANDLER
则继续往下执行注意：事务状态不会自动恢复，
ROLLBACK
必须显式写，否则可能留下部分提交的数据

应用代码中怎么可靠判断SQL是否执行失败

靠

mysql_affected_rows()

或类似接口判断“影响行数”是常见误区——它对

SELECT

返回 -1，对成功执行但没改数据的

UPDATE

返回 0，但这两者都不是错误。真正要捕获的是执行层面的失败。

PHP
mysqli
：检查
$mysqli->errno
是否非零，或调用
$mysqli->error
；面向对象风格下用
$mysqli->connect_errno
和
$mysqli->error
Python
pymysql
：必须用
try/except pymysql.Error as e:
，
e.args
是
(errno, error_message)
元组，例如
(1062, "Duplicate entry '1' for key 'PRIMARY'")
Node.js
mysql2
：监听
connection.on('error', ...)
处理连接级错误；单条查询用
await connection.execute(...)
并
catch
错误对象，其
code
字段是类似
ER_DUP_ENTRY
的符号名，
errno
是数字（如 1062）命令行
mysql -e "..."
：检查进程退出码，非零即失败（但无法区分错误类型）