SQL Server存储过程不能用单个OUTPUT参数返回多个统计值，必须为每个值声明独立OUTPUT参数（如@total_orders INT OUTPUT）或改用SELECT结果集；OUTPUT是标量引用机制，拼JSON或字符串会丢失类型且ORM无法映射；声明和调用两端均须显式标注OUTPUT，未赋值则返回NULL。
SQL Server 存储过程不能用单个 OUTPUT 参数返回多个统计值，必须为每个值声明独立的 OUTPUT 参数，或改用 SELECT 结果集。
OUTPUT 参数只能绑定单个变量，不能“打包”返回
OUTPUT 是按引用传递的标量机制，@total_count、@avg_amount、@max_date 这三个值必须各自声明为 INT OUTPUT、DECIMAL(18,2) OUTPUT、DATETIME OUTPUT。试图用一个 @result NVARCHAR(MAX) OUTPUT 拼接 JSON 或逗号字符串，会丢失类型、增加客户端解析负担，且无法被 Entity Framework 等 ORM 直接映射。
- 声明时漏写
OUTPUT关键字 → 参数变成只读输入，调用端收不到任何回写值 - 调用时漏写
OUTPUT（如@a = @x而非@a = @x OUTPUT）→ 对应变量保持原值或 NULL - 未在 EXEC 前
DECLARE变量 → 报错Must declare the scalar variable
多 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
调用时：
- 先
DECLARE @a INT, @b DECIMAL(18,2), @c DECIMAL(18,2) - 再
EXEC CalculateOrderStats '2024-01-01', '2024-12-31', @a OUTPUT, @b OUTPUT, @c OUTPUT - 如果存储过程中有
SELECT语句，必须先消费完所有结果集（如 ADO.NET 中反复调用reader.NextResult()），@a等变量才真正就绪；否则读到的是 NULL 或旧值
动态列或不确定数量的结果，别硬套 OUTPUT
比如按月份聚合销售额，月份数随查询范围变化——根本没法预设固定个数的 OUTPUT 参数。此时强行拼字符串（如 'Jan:1200;Feb:1500'）会导致：
- 客户端必须拆分、转换类型，易出错
- 数值变成字符串，后续计算要反复
CAST - ORM（如 EF Core 的
FromSqlRaw）无法自动映射，只能手写解析逻辑
正确做法是直接用 SELECT month_name, sales_amount 输出结果集，让客户端按行处理。
OUTPUT 和结果集可以共存，但顺序和消费逻辑不能乱
一个存储过程可同时有 SELECT 和多个 OUTPUT 参数。但注意：
- 结果集先发给客户端，OUTPUT 值在所有结果集被读取或跳过之后才可用
- SSMS 里看似“立刻可见”，是因为它自动遍历了全部结果集；程序里不手动处理，就读不到 OUTPUT 值
- JDBC 中必须用
SQLServerCallableStatement，先registerOutParameter，再execute，最后getXXX获取；不能用executeQuery替代
最易被忽略的一点：OUTPUT 参数若在存储过程中未被赋值（比如 WHERE 条件没匹配到任何行），调用端收到的就是 NULL，不是初始值或默认值——得在业务逻辑里主动判空。
