从C#向SQL Server传递DataTable时sp_executesql执行异常排查

当使用sp_executesql调用接收表值参数的存储过程时，无数据返回的核心原因几乎都是表值参数的传递方式不符合SQL Server要求，具体可分为以下几种情况：

1. 未显式指定表值参数的READONLY属性 #

SQL Server要求表值参数在声明时必须加上READONLY关键字，sp_executesql也遵循这一规则。如果遗漏该属性，或者类型名称与自定义表类型不匹配，会导致参数无法正确传递到存储过程，存储过程接收到空的表变量，自然无数据返回。

错误示例：

DECLARE @InputData DataTableType2;
-- 已向@InputData插入数据（Output#1可查询到）

EXEC sp_executesql 
N'EXEC yy_StoredProc @InputData',
N'@InputData DataTableType2' -- 错误：缺少READONLY属性

正确示例：

DECLARE @InputData DataTableType2;
-- 插入数据

EXEC sp_executesql 
N'EXEC yy_StoredProc @InputData',
N'@InputData DataTableType2 READONLY', -- 必须添加READONLY
@InputData = @InputData;

2. 参数名不匹配 #

存储过程定义的参数名与sp_executesql中传递的参数名不一致，会导致参数绑定失败，存储过程无法获取传入的数据。

比如存储过程定义：

CREATE PROCEDURE yy_StoredProc
    @InputData DataTableType2 READONLY
AS
-- 业务逻辑处理

错误的sp_executesql调用：

EXEC sp_executesql 
N'EXEC yy_StoredProc @Data', -- 参数名@Data与存储过程的@InputData不匹配
N'@InputData DataTableType2 READONLY',
@InputData = @InputData;

正确调用需保持参数名一致：

EXEC sp_executesql 
N'EXEC yy_StoredProc @InputData',
N'@InputData DataTableType2 READONLY',
@InputData = @InputData;

3. 表值参数未正确关联外部变量 #

如果在sp_executesql的执行语句内部重新声明了同名空表变量，而非引用外部已赋值的变量，会导致存储过程接收到空数据。

错误示例：

DECLARE @InputData DataTableType2;
-- 插入数据

EXEC sp_executesql 
N'DECLARE @InputData DataTableType2; EXEC yy_StoredProc @InputData', -- 内部重新声明空变量
N'', -- 未定义外部参数
@InputData = @InputData;

正确做法是直接引用外部传递的参数，不在sp_executesql内部重新声明同名变量。

4. 会话上下文差异（少见） #

如果存储过程依赖会话级临时对象或特定上下文设置，而sp_executesql的执行环境与直接调用时存在差异，也可能导致无数据返回。但根据你的测试场景（直接调用存储过程正常），这种可能性极低，优先排查前三种情况。

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