讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

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

小磊同学_8940

小磊同学_8940

发布时间:2026-11-16 11:34:19

|

421人浏览过

|

来源于php中文网

原创

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

示例:

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 → 连接被强制断开,根本来不及捕获

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

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

DeepSeek

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

WorkBuddy

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Lovart
Lovart Hot

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

豆包大模型

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

相关专题

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

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

5043

2023.10.12

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

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

1031

2023.10.27

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

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

1329

2024.02.23

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

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

7101

2024.03.06

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

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

3743

2024.03.06

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

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

7100

2024.04.07

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

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

9941

2024.04.29

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

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

1350

2024.04.29

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

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

精品课程

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

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