// SQL Server 错误参考

SQL Server 错误 8178:参数化查询需要一个参数

参数化查询(sp_executesql)声明了调用方未提供的参数,通常是客户端库遗漏的 NULL 值。

错误编号
8178
严重性
16
类别
名称与对象
错误信息
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

它的意思

客户端库通过以下方式发送参数化 SQL: sp_executesql 发送参数化 SQL,并附带声明的参数及其值的列表。如果声明的参数没有值,SQL Server 会抛出 8178。在 .NET 中,一个常见原因是将参数的值设置为 null,意思是“未提供”;数据库 NULL 必须是 DBNull.Value.

常见原因

  • 参数值为 null 而不是 DBNull.Value.
  • 在 SQL 文本中声明但从未添加到命令的参数。
  • SQL 中的参数名称与添加到命令的名称不匹配。

如何修复它

  1. 传入 DBNull.Value 针对 ADO.NET 中的 NULL,或者让库代劳(例如 Dapper 会把 null ,SQLly 会替你完成)。

  2. 确保每一 @parameter 都有一个值,并且名称匹配。

  3. 在 T-SQL 中,提供所有声明的参数。

    EXEC sys.sp_executesql
        N'SELECT * FROM dbo.Orders WHERE CustomerId = @c AND Status = @s',
        N'@c int, @s varchar(20)',
        @c = 42, @s = NULL;

相关错误

更多名称和对象错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。