SQL Server TVP不返回结果集问题排查（含ASP.NET调用代码）

咱们一步步拆解这个问题，从存储过程本身到ASP.NET调用环节逐个排查：

1. 先确认存储过程的定义是否正确 #

最常见的问题就是存储过程里没有明确返回TVP数据的逻辑。比如你的存储过程是不是只接收了TVP参数，但没写SELECT * FROM @YourTVPParameter这类返回语句？

举个正确的存储过程示例：

CREATE PROCEDURE Translator_SaveTextToSQLOne
    @TranslateData TranslateListOne READONLY
AS
BEGIN
    SET NOCOUNT ON; -- 最佳实践，避免返回额外的行数消息干扰结果

    -- 核心：必须通过SELECT语句返回传入的TVP数据
    SELECT * FROM @TranslateData;
END

另外要确认@TranslateData参数确实标记了READONLY（TVP参数强制要求只读），且类型和你创建的TranslateListOne完全匹配。

2. 验证自定义TVP类型的结构一致性 #

确保TranslateListOne的字段结构和你传入的数据完全匹配——字段名、数据类型、长度都不能错。比如你的TVP定义如果是：

CREATE TYPE TranslateListOne AS TABLE
(
    TextId INT,
    SourceText NVARCHAR(MAX),
    TargetText NVARCHAR(MAX)
);

那传入的数据（不管是SSMS里的变量还是ASP.NET的DataTable）的列名、类型必须和上面一致，否则数据无法正确映射到TVP中。

3. 手动执行存储过程验证SQL层面是否正常 #

先抛开ASP.NET，直接在SSMS里手动调用存储过程，看是否能返回结果：

-- 创建TVP变量并填充测试数据
DECLARE @tvp TranslateListOne;
INSERT INTO @tvp (TextId, SourceText, TargetText)
VALUES (1, 'Hello', '你好'), (2, 'World', '世界');

-- 调用存储过程
EXEC Translator_SaveTextToSQLOne @TranslateData = @tvp;

如果这个手动调用能返回结果，说明SQL层面没问题，问题大概率在ASP.NET的代码里；如果手动调用也无结果，那回到第一步检查存储过程的定义。

4. 排查ASP.NET调用代码的常见错误 #

假设你用的是SqlCommand，要注意这几个关键细节：

• 必须把参数的SqlDbType设为SqlDbType.Structured
• 必须指定TypeName为你的自定义类型名TranslateListOne（拼写、大小写要和SQL里的类型完全一致）
• 传入的DataTable（或可枚举结构）的列名要和TVP字段名匹配
• 执行命令时要用ExecuteReader()或Fill()获取结果集，不能用ExecuteNonQuery()（后者只返回受影响行数，不返回结果）

正确的ASP.NET代码示例：

// 构造符合TVP结构的DataTable
DataTable tvpTable = new DataTable();
tvpTable.Columns.Add("TextId", typeof(int));
tvpTable.Columns.Add("SourceText", typeof(string));
tvpTable.Columns.Add("TargetText", typeof(string));
tvpTable.Rows.Add(1, "Hello", "你好");
tvpTable.Rows.Add(2, "World", "世界");

using (SqlConnection conn = new SqlConnection("你的数据库连接字符串"))
{
    conn.Open();
    using (SqlCommand cmd = new SqlCommand("Translator_SaveTextToSQLOne", conn))
    {
        cmd.CommandType = CommandType.StoredProcedure;

        // 配置TVP参数
        SqlParameter tvpParam = cmd.Parameters.Add("@TranslateData", SqlDbType.Structured);
        tvpParam.TypeName = "TranslateListOne";
        tvpParam.Value = tvpTable;

        // 获取返回结果
        using (SqlDataReader reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                // 读取并处理数据
                int textId = reader.GetInt32(0);
                string sourceText = reader.GetString(1);
                // ...后续逻辑
            }
        }
    }
}

常见的坑：

• 误用ExecuteNonQuery()执行存储过程，导致无法获取结果集
• TypeName拼写错误，比如写成TranslateList少了后缀，导致无法识别TVP类型
• DataTable列名和TVP字段名不匹配，比如TVP是SourceText，DataTable列是Source，导致数据无法传递

5. 利用Profiler捕获的语句进一步验证 #

你提到调用exec sp_executesql前查询@p3有正确数据，那可以把Profiler捕获到的完整sp_executesql语句直接在SSMS里执行，看是否有结果。比如捕获到的语句可能类似：

exec sp_executesql N'EXEC Translator_SaveTextToSQLOne @TranslateData = @p3',N'@p3 TranslateListOne READONLY',@p3=...

如果执行这个语句有结果，说明SQL层面没问题，问题在ASP.NET的调用逻辑；如果执行也无结果，那还是存储过程的定义有问题。

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