Dapper调用SQL存储过程无法正确返回单值stageOrder的问题解决

• 第一处错配：SQL 存储过程的RETURN语句本身是用来返回存储过程执行状态码的，不是用来传业务查询结果的常规方式。而且 Dapper 的QuerySingle<int>默认只会读取存储过程输出的结果集的首行首列值，根本不会去捕获RETURN语句输出的那个整型值；另外如果匹配不到对应记录，你定义的@SomeVal会为NULL，而SQL的RETURN语句不允许返回NULL值，会直接抛出运行错误。这就是你现在拿不到正确值、甚至报运行错的最主要原因。
• 第二处问题：原存储过程的查询写法冗余，把入参过滤条件放在HAVING子句里，会先把全表数据做分组聚合，再筛选匹配条件，性能比在WHERE阶段提前过滤的写法差很多；同时原 SELECT 同时输出多列字段、又给变量赋值，会生成结构混乱的结果集，进一步导致 Dapper 取值匹配失败。

方案1：直接返回单值结果集（零改动兼容你现有Dapper调用代码） #

调整后的存储过程代码：

CREATE OR ALTER PROCEDURE [dbo].[ManufacturingStages_ReturnNextOrder]
    @StageType nvarchar(50),
    @StageRelatedPart int
AS
BEGIN
    -- 直接输出单行单列的最大stageOrder值
    SELECT ISNULL(MAX(stageOrder), 0)
    FROM ProductManufacturingStages
    WHERE 
        stageType = @StageType
        AND stageRelatedPart = @StageRelatedPart
END

调整说明：

• 用WHERE替代原有的HAVING做过滤，在聚合计算前就筛掉不需要的数据，查询效率更高
• 用ISNULL包裹聚合结果，当匹配不到任何记录时返回默认值0，避免出现NULL赋值给int类型时报错
• 输出的单行单列结果集，可以被Dapper的QuerySingle<int>直接读取，和你现有的C#调用代码完全适配，不需要额外修改任何调用逻辑

方案2：通过输出参数返回值（无结果集输出的实现方式） #

如果你希望存储过程不产生可读取的结果集，仅通过参数传递返回值，可按如下方式调整：
调整后的存储过程代码：

CREATE OR ALTER PROCEDURE [dbo].[ManufacturingStages_ReturnNextOrder]
    @StageType nvarchar(50),
    @StageRelatedPart int,
    @NextOrder int OUTPUT
AS
BEGIN
    SELECT @NextOrder = ISNULL(MAX(stageOrder), 0)
    FROM ProductManufacturingStages
    WHERE 
        stageType = @StageType
        AND stageRelatedPart = @StageRelatedPart
END

对应的C#调用代码需要同步调整，显式标记输出参数：

DynamicParameters parameters = new DynamicParameters();
parameters.Add("@StageType", "Manufacturing");
parameters.Add("@StageRelatedPart", 8137);
// 新增输出参数的定义，指定参数方向
parameters.Add("@NextOrder", dbType: DbType.Int32, direction: ParameterDirection.Output);

// 无返回结果集时用Execute方法执行即可
Globals.db.Execute("ManufacturingStages_ReturnNextOrder", parameters, commandType: CommandType.StoredProcedure);
// 从参数对象中取出输出值
int nextOrder = parameters.Get<int>("@NextOrder");

如果坚持保留原存储过程里RETURN返回值的写法，也需要在C#端单独添加一个参数方向为ParameterDirection.ReturnValue的参数才能捕获对应值。这种用法是SQL存储过程的特殊约定，不适合作为业务查询值的常规传递方式。

内容的提问来源于stack exchange，提问作者Shadyjunior