SQL Server OUTPUT参数仅支持单值返回，多结果应使用SELECT结果集或多个OUTPUT参数；动态列场景必须用结果集，避免字符串拼接。
SQL Server 存储过程 OUTPUT 参数只能返回单个值，不能直接返回多个结果集
OUTPUT 参数本质是“传引用”的标量参数，每次只能绑定一个变量、接收一个值。想用它“返回多个计算结果”，常见误解是试图塞进 JSON 字符串或逗号分隔字符串——这虽可行但违背 OUTPUT 设计本意，也丧失类型安全和调用端解析便利性。
真正适合多结果的场景，应该用 SELECT 语句输出结果集，或组合使用多个 OUTPUT 参数（每个对应一个计算值）。
- 如果 3 个计算结果都是简单标量（如
@total_count、@avg_amount、@max_date），定义 3 个 OUTPUT 参数最清晰 - 如果结果结构复杂（如汇总行+明细行），必须用
SELECT输出多个结果集，客户端通过SqlDataReader.NextResult()切换 - SQL Server 2016+ 可考虑用
FOR JSON拼成单个 JSON 字符串走一个 OUTPUT 参数，但调用端需额外解析，且无法利用数据库类型推导
定义多个 OUTPUT 参数并正确调用的完整写法
关键在声明时加 OUTPUT，调用时也必须显式用 OUTPUT 关键字传参，否则参数不会回写。
CREATE PROCEDURE dbo.CalculateOrderStats
@start_date DATE,
@end_date DATE,
@total_orders INT OUTPUT,
@total_revenue DECIMAL(18,2) OUTPUT,
@avg_order_size DECIMAL(18,2) OUTPUT
AS
BEGIN
SELECT
@total_orders = COUNT(*),
@total_revenue = ISNULL(SUM(amount), 0),
@avg_order_size = ISNULL(AVG(CAST(order_items AS FLOAT)), 0)
FROM orders
WHERE order_date BETWEEN @start_date AND @end_date;
END
调用时注意：
- 必须用变量接收，不能直接传字面量：
EXEC CalculateOrderStats '2024-01-01', '2024-12-31', @a OUTPUT, @b OUTPUT, @c OUTPUT - 所有 OUTPUT 参数在 EXEC 前要先声明，哪怕只用其中两个
- 如果某 OUTPUT 参数未被存储过程中赋值，调用端读到的是 NULL（不是初始值）
当需要返回动态列或不确定数量的结果时，别硬塞 OUTPUT
比如按月份统计销售额，月份数量随查询范围变化——这种没法预设固定个数的 OUTPUT 参数。强行拼接成字符串（如 'Jan:1200;Feb:1500'）会导致：
- 客户端必须写分割+解析逻辑，易出错
- 丢失数值类型，后续计算要反复
CAST - 无法利用 ORM 的结果集映射（如 Entity Framework 的
FromSqlRaw直接映射到 List<T>）
正确做法是改用结果集：
SELECT
FORMAT(order_date, 'yyyy-MM') AS month_key,
COUNT(*) AS order_count,
SUM(amount) AS revenue
FROM orders
WHERE order_date BETWEEN @start_date AND @end_date
GROUP BY FORMAT(order_date, 'yyyy-MM')
ORDER BY month_key;
这样客户端用标准数据读取器就能拿到强类型列表，比解析字符串可靠得多。
OUTPUT 参数的常见陷阱：没赋值、没声明 OUTPUT、类型不匹配
这三个错误不会报语法错，但会导致调用端拿到意外值：
-
@total_orders在存储过程中漏写赋值 → 调用端收到 NULL，即使声明时写了INT = 0 - EXEC 时漏写
OUTPUT关键字（如EXEC ... @a, @b）→ 参数按 INPUT 处理，存储过程里改了也不回传 - 声明为
DECIMAL(10,2)，但 SELECT 中用SUM(CAST(... AS INT))→ 精度截断，小数位丢失
调试建议：在存储过程末尾加 SELECT @param1, @param2 确认值已正确计算；调用前用 DECLARE @x INT = -999 初始化，便于识别是否被覆盖。
OUTPUT 参数不是万能返回通道，它的价值在于明确契约——调用方知道会拿到几个确定类型的值。该用结果集的地方硬套 OUTPUT，反而让逻辑变脆弱。
