怎么在SQL存储过程中使用RAISERROR抛出自定义错误码

小磊同学_8940

小磊同学_8940

2026-11-16

421人浏览

原创

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

怎么在sql存储过程中使用raiserror抛出自定义错误码

必须用大于 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 对应整数

示例:

MiniMax
MiniMax

MiniMax是一款AI工具,推出的AI智能问答助手。

下载
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 块或被 .NET SqlException 捕获

容易踩的坑

这几个点不注意,RAISERROR 会静默失败或行为异常:

  • state 设为 0 或 > 127 → 直接报语法错误,语句中断
  • 动态参数个数与占位符不匹配 → 报错「参数数量不匹配」,且不会输出部分消息
  • 用 WITH LOG 但无 sysadmin 权限 → 报错并终止执行
  • 在 TRY…CATCH 外直接抛 severity ≥ 20 → 连接被强制断开,根本来不及捕获

真正关键的不是“怎么抛”,而是“抛出去后谁来接”——错误号是否唯一、是否可被上层程序稳定识别,这点比格式漂亮重要得多。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

存储过程

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.10.12

5043

8

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

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

2023.10.27

1031

4

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

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

2024.02.23

1329

5

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

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

2024.03.06

7101

10

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

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

2024.03.06

3743

4

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

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

2024.04.07

7100

11

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

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

2024.04.29

9941

6

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

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

2024.04.29

1350

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1172

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
布尔教育燕十八mysql高级视频教程
布尔教育燕十八mysql高级视频教程

共24课时 | 8.6万人学习

魔乐科技oracle视频教程
魔乐科技oracle视频教程

共27课时 | 6.7万人学习

肖文吉Oracle视频教程
肖文吉Oracle视频教程

共33课时 | 9.1万人学习