MySQL SIGNAL SQLSTATE 怎样让存储过程返回可读错误
我在存储过程中做业务校验时,最不愿意看到的是用一条“故意失败”的 SQL 代替真正的错误说明:调用方只能拿到模糊的表不存在或约束错误,日志也很难区分库存不足、参数非法和系统故障。MySQL 的 SIGNAL 就是为这类场景准备的:主动抛出一个 SQLSTATE,并且可以同时设置 MESSAGE_TEXT 和 MYSQL_ERRNO。
官方文档:https://dev.mysql.com/doc/refman/8.4/en/signal.html
要让存储过程返回可读错误,通常写成SIGNAL SQLSTATE '45000' SET MYSQL_ERRNO = 自定义编号, MESSAGE_TEXT = '给调用方看的说明'。00类 SQLSTATE 代表成功,不能拿来 SIGNAL;01类是警告,不会像异常一样终止过程。
先把三个错误字段分清楚
SQLSTATE 是五个字符的状态值,决定这是警告、未找到还是异常;MESSAGE_TEXT 是人和日志最容易读懂的说明;MYSQL_ERRNO 是 MySQL 侧的数字错误码。三者是同一个信号的不同观察面,不要把数字错误码当成 SQLSTATE 使用。
| 字段 | 适合解决的问题 | 写法注意 |
|---|---|---|
| SQLSTATE | 让调用方按错误类别判断 | 必须是五字符值,异常常用非 00、01、02 类 |
| MYSQL_ERRNO | 让 MySQL 客户端记录稳定数字码 | 是 MySQL 扩展项,不等同于 SQLSTATE |
| MESSAGE_TEXT | 给日志和用户展示可读原因 | 不要把敏感数据拼进错误文本 |

用 SIGNAL 把库存校验变成可读错误
下面的例子只做一个边界清楚的动作:库存不足时主动结束存储过程,并把原因交给调用方。45000 表示未进一步细分的用户定义异常;自定义数字码与消息则负责让日志更容易定位。
DELIMITER //
CREATE PROCEDURE reserve_stock(IN requested_qty INT, IN available_qty INT)
BEGIN
-- 先拒绝非正数,避免把参数错误混进库存不足。
IF requested_qty available_qty THEN
SIGNAL SQLSTATE '45000'
SET MYSQL_ERRNO = 30002,
MESSAGE_TEXT = '库存不足,无法完成预留';
END IF;
-- 校验通过后才进入真正的扣减或预留逻辑。
SELECT 'ok' AS result;
END//
DELIMITER ;
这里的两个 SIGNAL 共享异常类,但使用不同的 MYSQL_ERRNO。调用方可以按数字码区分输入错误和库存不足,日志仍然保留自然语言。示例没有把订单号、手机号等业务数据直接塞进消息,避免错误文本变成隐私泄露渠道。
调用方怎样拿到 SQLSTATE 和 MESSAGE_TEXT
在 SQL 客户端里,过程抛出异常后可以用 SHOW ERRORS 或 SHOW WARNINGS 查看错误信息。对于程序客户端,驱动一般会同时暴露数字错误码、SQLSTATE 和消息字符串;应用层应把这三项记录到结构化日志,再决定给用户返回哪一段文字。
CALL reserve_stock(12, 3);
-- 过程报错后查看最近一次错误的代码与消息。
SHOW ERRORS;
-- 若使用的是 01 类 SIGNAL,则应查看警告而不是把它当异常。
SHOW WARNINGS;
要点是不要只依赖 MESSAGE_TEXT 做程序分支。消息适合阅读,SQLSTATE 和 MYSQL_ERRNO 才更适合稳定判断。SQL 层输出的 Code、Message 与客户端 API 看到的错误信息属于同一诊断结果的不同入口。

已经有处理器时,用 RESIGNAL 保留原错误
SIGNAL 是创建一个新的条件,RESIGNAL 则用于条件处理器内部把当前错误继续传出去。最容易踩坑的是:处理器里先执行了别的 SQL,原诊断信息可能被覆盖;这时可以直接 RESIGNAL,或者只改写消息后再抛出。
DELIMITER //
CREATE PROCEDURE load_order(IN order_id BIGINT)
BEGIN
-- 记录或补充处理动作后,把原始异常继续交给上层。
DECLARE EXIT HANDLER FOR SQLEXCEPTION
BEGIN
-- 不改变原 SQLSTATE、错误码和消息,避免丢失根因。
RESIGNAL;
END;
-- 这里代表可能产生原始异常的查询。
SELECT id, status FROM orders WHERE id = order_id;
END//
DELIMITER ;
只有当前处在 condition handler 中时,RESIGNAL 才合法。若目标是把底层错误转换成更稳定的业务错误,可以在处理器里使用带 SET 的 RESIGNAL,但应保留足够的根因信息,避免所有错误都变成同一个“操作失败”。
这几个边界决定了错误是否真的可用
- 不要使用 00 类 SQLSTATE。它表示成功,不是合法的 SIGNAL 异常类别;01 类是 warning,02 类是 not found,其他合法类别通常作为异常处理。
- 不要给诊断项赋 NULL。需要省略某项时就不写它,不能用 NULL 假装“没有值”。
- MESSAGE_TEXT 不是接口契约的全部。调用方应优先按 SQLSTATE 或自定义错误码分支,消息只作为展示和排障补充。
- 别把 SIGNAL 和 RESIGNAL 混为一谈。前者主动创建条件,后者在处理器里传递当前条件,适用位置不同。
常见追问
SIGNAL 会不会让存储过程继续执行?
异常类 SIGNAL 会终止当前过程的后续语句;01 类是 warning,通常不会像异常一样终止流程。因此先确定 SQLSTATE 类别,再设计调用方的控制流。
自定义 MYSQL_ERRNO 能不能替代 SQLSTATE?
不能。MYSQL_ERRNO 是 MySQL 扩展的数字信息,SQLSTATE 仍然是 SIGNAL 必须提供的状态值。两者一起使用,调用方才同时拥有分类与可记录的数字码。
什么时候应该用 RESIGNAL?
当处理器需要记录、清理或补充动作,同时又不能吞掉原始条件时使用 RESIGNAL;如果要从头创建一个新的业务错误,才使用 SIGNAL。
把错误写清楚的关键不是堆更多文本,而是让 SQLSTATE、MYSQL_ERRNO 和 MESSAGE_TEXT 各司其职:状态值负责分类,数字码负责稳定识别,消息负责解释原因。这样存储过程的失败就能被 SQL 客户端、应用日志和上层处理器一致地理解。
MySQL SET_VAR 提示怎样只为单条查询调整执行参数
- 上一篇
- MySQL SET_VAR 提示怎样只为单条查询调整执行参数
- 下一篇
- MySQL UUID_TO_BIN 怎样保留 UUID 的时间排序
-
- 数据库 · MySQL | 12分钟前 |
- MySQL JSON_TABLE 怎样处理缺失字段的 DEFAULT ON EMPTY
- 234浏览 收藏
-
- 数据库 · MySQL | 15分钟前 |
- MySQL HANDLER READ 怎样按索引逐行读取表数据
- 490浏览 收藏
-
- 数据库 · MySQL | 17分钟前 | MySQL · uuid · mysql VARBINARY(16) UUID_TO_BIN BIN_TO_UUID UUID v1 UUID索引
- MySQL UUID_TO_BIN 怎样保留 UUID 的时间排序
- 273浏览 收藏
-
- 数据库 · MySQL | 40分钟前 |
- MySQL SET_VAR 提示怎样只为单条查询调整执行参数
- 428浏览 收藏
-
- 数据库 · MySQL | 41分钟前 | MySQL · 数据库 · 触发器 · 表结构 · mysql 触发器 CREATE TABLE LIKE SHOW TRIGGERS 表结构复制
- MySQL CREATE TABLE LIKE 怎样判断触发器是否需要单独复制
- 204浏览 收藏
-
- 数据库 · MySQL | 46分钟前 | MySQL · 索引 · 性能优化 · mysql explain 索引优化 Invisible Index
- MySQL 8.4 invisible index 怎样临时验证索引是否值得保留
- 242浏览 收藏
-
- 数据库 · MySQL | 1天前 | MySQL · SQL · mysql 动态SQL 反引号 sys.quote_identifier
- MySQL sys.quote_identifier 怎样处理名称中的反引号
- 304浏览 收藏
-
- 数据库 · MySQL | 1天前 |
- MySQL SAVEPOINT 怎样只回滚事务中的一段操作
- 197浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1080次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1079次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1244次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1184次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1029次使用
-
- MySQL EXPLAIN ANALYZE 实战:慢查询别只盯着 possible_keys
- 2026-06-02 389浏览
-
- MySQL InnoDB 死锁实战:别只会等 lock wait timeout
- 2026-06-02 105浏览
-
- MySQL 在线 DDL 实战:ALTER TABLE 别把业务卡在 MDL 上
- 2026-06-02 323浏览
-
- MySQL 8.4 写入一抖就怪磁盘?先把 redo log 容量和检查点看明白
- 2026-06-02 382浏览
-
- MySQL 不可见索引实战:想删索引又怕翻车,先做一次生产级预演
- 2026-06-02 388浏览

