在MySQL数据库开发中，触发器能够在数据变更前后自动执行一段逻辑，常用于数据校验、审计和关联更新。当校验不通过时，我们需要中断当前的INSERT、UPDATE或DELETE操作，并向调用方返回明确的错误原因。MySQL提供了SIGNAL语句配合SQLSTATE来实现在触发器内部主动抛出异常，从而让存储过程、应用程序准确感知失败。
一、为什么触发器里需要主动抛出异常
在早期MySQL版本中，触发器内部如果出现运行时错误，例如除以零、字段约束冲突，确实会让语句失败。但如果我们只是想在业务逻辑上拒绝某些数据，比如订单金额不能为负，触发器里写一段IF判断后并没有机制通知外部，仅仅是SELECT一个错误信息，客户端拿到的是结果集而不是异常，事务依旧可能提交，数据照样写进表。
使用SIGNAL SQLSTATE可以将一个符合SQL标准的状态码和自定义消息抛出，MySQL收到后会终止当前语句并回滚触发器所在隐式事务（对于非事务表则停止后续操作）。这样调用方无论是JDBC、MyBatis还是命令行客户端，都能像捕获普通SQL错误一样拿到错误信息，而不需要额外去解析结果集。
二、SIGNAL SQLSTATE基本语法
SIGNAL语句用于“发出”一个错误或警告信号。在触发器中最常见的写法是指定一个SQLSTATE值，并通过SET MESSAGE_TEXT来附带人类可读的信息。SQLSTATE是五个字符的标准代码，例如'45000'代表未处理的用户自定义异常。
下面是一个最简单的结构示例，展示在触发器内如何抛出错误：
DELIMITER $$
CREATE TRIGGER before_employee_insert
BEFORE INSERT ON employee
FOR EACH ROW
BEGIN
IF NEW.salary < 0 THEN
SIGNAL SQLSTATE '45000'
SET MESSAGE_TEXT = '员工薪资不能为负数';
END IF;
END$$
DELIMITER ;
在上面的代码中，NEW.salary代表即将插入的行中salary字段的值。一旦它小于零，SIGNAL就会中断INSERT，客户端收到错误代码45000及对应消息。注意DELIMITER的修改只是为了在命令行里正确定义包含分号的触发器体。
三、在触发器中返回自定义错误的最佳实践
虽然'45000'可以用，但更规范的做法是使用以'45'开头、后面三位自定的状态码，或者利用已定义的SQLSTATE类别。例如'45001'可以表示某类业务校验失败。通过一致的编码，应用程序能根据状态码做不同处理，而不只是依赖消息文字。
以下示例展示一个稍复杂的BEFORE UPDATE触发器，它同时校验两个字段，并返回不同的自定义状态码：
DELIMITER $$
CREATE TRIGGER before_product_update
BEFORE UPDATE ON product
FOR EACH ROW
BEGIN
IF NEW.price <= 0 THEN
SIGNAL SQLSTATE '45010'
SET MESSAGE_TEXT = '商品价格必须大于零';
ELSEIF NEW.stock < 0 THEN
SIGNAL SQLSTATE '45011'
SET MESSAGE_TEXT = '商品库存不能为负';
END IF;
END$$
DELIMITER ;
这种分段校验方式让前端或后端服务能明确知道是哪一类规则被打破。比如在Java中，捕获SQLException后通过getSQLState()方法就能拿到'45010'，再决定提示用户“价格非法”还是“库存非法”，比解析消息更稳定。
四、与旧式错误处理方式的对比
在没有SIGNAL的MySQL老版本（5.5之前某些环境）或开发者不熟悉SIGNAL时，有人会在触发器里调用一个必然会失败的存储过程，例如插入一个不存在的表，用副作用制造错误。这种方式极不直观，且错误信息混乱，难以维护。
我们用一个对比表来看两种方案的差异：
| 方案 | 可读性 | 错误码可控性 | 客户端捕获难度 |
|---|---|---|---|
| 调用错误存储过程制造异常 | 差，隐藏副作用 | 低，依赖系统随机码 | 高，需解析系统消息 |
| SIGNAL SQLSTATE自定义抛出 | 好，语义明确 | 高，可指定45000+ | 低，直接取SQLSTATE |
显然，SIGNAL方式在工程化层面优势明显。它不仅让触发器逻辑清晰，也保证了数据库层与业务层错误契约的稳定。
五、客户端如何捕获并处理这些错误
以常见的命令行和编程接口为例，当触发器抛出SIGNAL后，命令行会直接显示ERROR 1644 (45000): 员工薪资不能为负数。在应用程序中，错误被封装为标准的数据库异常对象。
下面是一段Python使用pymysql的捕获示例：
import pymysql
conn = pymysql.connect(host='127.0.0.1', user='root', password='test', db='demo')
try:
with conn.cursor() as cur:
cur.execute("INSERT INTO employee(name, salary) VALUES('张三', -100)")
conn.commit()
except pymysql.err.InternalError as e:
code, msg = e.args
print("捕获到触发器异常，SQLSTATE相关码:", code)
print("错误信息:", msg)
conn.rollback()
通过这种方式，即便校验写在数据库触发器里，应用层也能像处理普通SQL错误一样回滚并提示用户。将关键规则下沉到触发器配合SIGNAL，既防止了绕过业务代码的脏数据，也保持了错误链路通畅。
mysql触发器SIGNAL_SQLSTATE自定义错误修改时间：2026-08-06 20:36:31