讲师中心 微信公众号
AI工具推荐 视频效率加速

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

冬萱姑娘_6646

冬萱姑娘_6646

发布时间:2026-02-22 09:07:02

|

491人浏览过

|

来源于php中文网

原创

MySQL客户端执行SQL出错时,错误信息由服务端通过协议包返回错误码和消息,客户端接收后才抛异常或设错误标志;不主动检查返回值或捕获异常会导致错误被静默忽略。

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

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。

常见写法:

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
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 "...":检查进程退出码,非零即失败(但无法区分错误类型)

为什么 SET sql_mode 不是错误处理,而是预防手段

sql_mode 控制的是“什么算错误”,而不是“怎么处理错误”。比如开启 STRICT_TRANS_TABLES 后,向 NOT NULL 字段插 NULL 会报错;关闭它则静默转成默认值(如空字符串或 0)。

这看起来像“容错”,实则是掩盖问题源头:

  • INSERT INTO t(a) VALUES(NULL) 在非严格模式下可能成功,但业务逻辑已偏离预期
  • 不同环境(开发/生产)sql_mode 不一致,会导致相同SQL行为不一致,调试困难
  • 它不能替代应用层的错误捕获——即使开了严格模式,主键冲突、锁等待超时等仍需按异常处理

真正容易被忽略的是:错误码的语义依赖 MySQL 版本和配置。比如 1205(死锁)在 5.7 和 8.0 中都存在,但 3819(check constraint violation)只在 8.0.16+ 支持。写通用错误处理时,别只认数字,优先匹配 SQLSTATE 或错误消息子串。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4003

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

851

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1049

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5861

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2783

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5840

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7761

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1050

2024.04.29

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 178人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 285人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn