必须用大于50000的错误号注册自定义错误码,先执行sp_addmessage(需sysadmin权限)将错误号(如50001)、严重级、消息文本和语言存入sys.messages,再用RAISERROR(50001,16,1,@param)调用;未注册时可用RAISERROR(N'消息',16,1)但错误号固定为50000。

必须用大于 50000 的错误号才能注册为自定义错误码,否则 RAISERROR 只会抛出默认的 50000 号错误,无法被 C# 或其他客户端按业务逻辑区分捕获。
如何注册一个可复用的自定义错误号(>50000)
直接调用 RAISERROR 传入数字 ID 时,该 ID 必须已存在于 sys.messages 中;否则会报错“消息 ****** 在 sys.messages 中未找到”。所以得先用 sp_addmessage 注册:
-
sp_addmessage只能由sysadmin角色执行,普通数据库用户无权调用 - 错误号必须 > 50000(比如
50001),且不能与现有系统/用户错误冲突 - 语言建议指定为
'us_english'或当前数据库默认语言,避免跨环境失效 - 注册后需配合
sp_dropmessage管理,否则长期残留
示例(在 master 或目标数据库中执行一次):
EXEC sp_addmessage
@msgnum = 50001,
@severity = 16,
@msgtext = N'库存不足:商品 %s 当前剩余 %d 件',
@lang = 'us_english';
RAISERROR 调用自定义错误号的写法
注册成功后,RAISERROR 就能用数字 ID 替代字符串消息体,且支持动态参数替换:
- 第一个参数是整数错误号(如
50001),不是字符串 - 后续仍需传
severity和state,且severity建议保持与注册时一致(否则可能被截断或忽略) - 动态参数顺序、类型必须严格匹配
@msgtext中的%s、%d占位符 - 不支持
%f或宽字符以外的复杂格式,%s对应nvarchar,%d对应整数
示例:
DECLARE @sku nvarchar(20) = N'ABC-1001'; DECLARE @stock int = 0; RAISERROR(50001, 16, 1, @sku, @stock);
执行后返回错误:「库存不足:商品 ABC-1001 当前剩余 0 件」,错误号为 50001。
不注册错误号时的替代方案(推荐多数场景)
如果没权限执行 sp_addmessage,或只是临时校验逻辑,直接用字符串消息体更实际:
-
RAISERROR(N'订单状态非法:%s', 16, 1, @status)—— 错误号固定为50000 - 客户端(如 C#)靠错误消息文本做关键字匹配,而非错误号
- 注意:字符串必须加
N''前缀,否则中文会乱码 - 严重级选
11–19(常用16),确保能进CATCH块或被 .NETSqlException捕获
容易踩的坑
这几个点不注意,RAISERROR 会静默失败或行为异常:
-
state设为0或 >127→ 直接报语法错误,语句中断 - 动态参数个数与占位符不匹配 → 报错「参数数量不匹配」,且不会输出部分消息
- 用
WITH LOG但无sysadmin权限 → 报错并终止执行 - 在
TRY…CATCH外直接抛severity ≥ 20→ 连接被强制断开,根本来不及捕获
真正关键的不是“怎么抛”,而是“抛出去后谁来接”——错误号是否唯一、是否可被上层程序稳定识别,这点比格式漂亮重要得多。











