// SQL Server 错误参考
SQL Server 错误 8178:参数化查询需要一个参数
参数化查询(sp_executesql)声明了调用方未提供的参数,通常是客户端库遗漏的 NULL 值。
- 错误编号
8178- 严重性
- 16
- 类别
- 名称与对象
它的意思
客户端库通过以下方式发送参数化 SQL: sp_executesql 发送参数化 SQL,并附带声明的参数及其值的列表。如果声明的参数没有值,SQL Server 会抛出 8178。在 .NET 中,一个常见原因是将参数的值设置为 null,意思是“未提供”;数据库 NULL 必须是 DBNull.Value.
常见原因
- 参数值为
null而不是DBNull.Value. - 在 SQL 文本中声明但从未添加到命令的参数。
- SQL 中的参数名称与添加到命令的名称不匹配。
如何修复它
-
传入
DBNull.Value针对 ADO.NET 中的 NULL,或者让库代劳(例如 Dapper 会把null,SQLly 会替你完成)。 -
确保每一
@parameter都有一个值,并且名称匹配。 -
在 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;
相关错误
更多名称和对象错误
208无效的对象名称207无效的列名称4104多部分标识符未绑定209列名不明确2812无法找到存储过程2714已存在名为3701无法删除,未找到对象3702无法删除数据库,当前正在使用中
代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQL Server
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。