// PostgreSQL 错误参考
PostgreSQL 42P02:参数不存在
SQL 中包含 $1 风格的占位符,但没有绑定参数值,这通常是因为直接运行了驱动 SQL,或占位符出现在引号内。
- SQLSTATE
42P02- 名称
undefined_parameter
它的意思
PostgreSQL 自己的占位符是 $1, $2 等等,会在语句预编译或以绑定参数执行时填充进去。如果文本中包含 $1 但语句发送时没有带参数,PostgreSQL 没有东西可替换,就会以 42P02(undefined_parameter).
这通常意味着从应用程序代码或日志中复制的 SQL 是手动运行的,或者驱动程序通过不绑定它们的路径发送了带占位符的查询字符串。
常见原因
- 在 psql 或 SQL 编辑器中运行从代码或日志中复制的参数化查询。
- 字符串内或美元引号包裹的函数体内的占位符,驱动程序不会替换它们。
- A
DO块,或者写成动态 SQL,用$1无EXECUTE ... USING. - 混合驱动程序占位符样式:
?或者%s在一个地方,$1在另一个地方。
如何修复它
-
手动运行时,用字面值替换占位符,或使用
PREPARE和EXECUTE.PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1; EXECUTE find_order(42);
-
在 PL/pgSQL 内部的动态 SQL 中,传递值时请使用
USING.DO $$ DECLARE n int; BEGIN EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42; RAISE NOTICE '%', n; END; $$; -
在应用程序代码中,通过驱动程序的参数 API 传递值,而不是将它们拼接起来。
安全地复现它
SELECT $1; -- ERROR: there is no parameter $1
相关错误
更多语法错误或访问规则违例错误
42501权限被拒绝42846无法强制转换42803列必须出现在 GROUP BY 子句中42830外键无效42804数据类型不匹配42703列不存在42883函数不存在42P01关系不存在
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。