在SQL Server的存储过程开发过程中,当逻辑较为复杂或者出现执行异常时,直接排查问题往往比较困难,此时输出打印调试信息可以直观展示执行过程中的变量值、分支走向等内容,快速定位问题所在。PRINT和RAISERROR是SQL Server提供的两种常用调试信息输出方式,适用场景各有不同。

PRINT输出调试信息
PRINT是SQL Server中最基础的调试信息输出语句,使用方式非常简单,直接将需要输出的内容作为参数传入即可。它的主要作用是将信息输出到消息窗口,适合输出简单的提示或者变量值。
基本用法
PRINT支持输出字符串、变量以及拼接后的内容,示例如下:
-- 定义存储过程
CREATE PROCEDURE TestPrintDebug
@userId INT,
@userName NVARCHAR(50)
AS
BEGIN
-- 输出固定提示信息
PRINT '存储过程开始执行'
-- 输出传入的参数值
PRINT '传入的用户ID:' + CAST(@userId AS NVARCHAR(20))
PRINT '传入的用户名:' + @userName
-- 模拟业务逻辑
DECLARE @score INT = 85
PRINT '用户得分:' + CAST(@score AS NVARCHAR(20))
PRINT '存储过程执行结束'
END
GO
-- 执行存储过程
EXEC TestPrintDebug @userId=1001, @userName='张三'
使用限制
PRINT语句存在几个比较明显的限制:
- 只能输出字符串类型的内容,输出数值、日期等其他类型时需要使用
CAST或CONVERT函数转换。 - 没有严重的级别控制,所有PRINT输出的信息都会直接显示在消息窗口,无法区分信息的重要程度。
- 不支持带格式的输出,也无法在输出信息的同时终止存储过程的执行。
RAISERROR输出调试信息
RAISERROR的功能比PRINT更加强大,不仅可以输出调试信息,还可以指定错误的严重级别、状态,甚至可以在输出信息后终止存储过程的执行,适合需要区分信息重要程度或者需要触发异常的场景。
基本用法
RAISERROR的语法格式为:RAISERROR ( 消息, 严重级别, 状态 ),其中严重级别范围为0到25,状态范围为1到127,示例如下:
-- 定义存储过程
CREATE PROCEDURE TestRaiserrorDebug
@orderId INT
AS
BEGIN
-- 严重级别0,普通提示信息
RAISERROR('开始处理订单ID:%d', 0, 1, @orderId)
-- 模拟业务判断
IF @orderId < 1000
BEGIN
-- 严重级别10,警告信息
RAISERROR('订单ID小于1000,属于测试订单', 10, 1)
END
ELSE
BEGIN
-- 严重级别16,错误信息,会终止后续执行
RAISERROR('订单ID不符合业务规范', 16, 1)
-- 下面的语句不会执行
PRINT '订单处理完成'
END
END
GO
-- 执行存储过程
EXEC TestRaiserrorDebug @orderId=500
参数说明
RAISERROR的各个参数作用如下:
| 参数 | 说明 |
|---|---|
| 消息 | 要输出的内容,支持类似C语言printf的格式化占位符,比如%d代表整数、%s代表字符串 |
| 严重级别 | 0-9为普通信息,不会中断执行;10-16为错误级别,16及以上会中断存储过程执行;17及以上需要管理员权限 |
| 状态 | 1-127之间的整数,用于标识同一错误的不同场景,方便排查问题 |
两种方式对比
PRINT和RAISERROR的核心差异如下:
- 功能丰富度:RAISERROR支持级别控制、格式化输出、中断执行,PRINT仅能输出简单字符串。
- 执行控制:RAISERROR严重级别16及以上会终止存储过程执行,PRINT不会影响执行流程。
- 使用复杂度:PRINT语法简单,适合快速输出简单信息;RAISERROR参数更多,适合复杂调试场景。
使用建议
实际开发中可以根据场景选择:
- 如果只是临时输出简单的变量值或者执行提示,优先使用PRINT,语法简单效率高。
- 如果需要区分调试信息的重要程度,或者需要在特定条件下终止存储过程执行,使用RAISERROR更合适。
- 调试完成后,记得删除或者注释掉不必要的调试输出语句,避免影响正式环境的执行效率。
注意:如果存储过程中包含事务操作,使用RAISERROR输出错误并中断执行时,需要提前做好事务回滚处理,避免数据不一致问题。
SQL_Server存储过程PRINTRAISERROR调试信息修改时间:2026-06-16 10:24:38