// PostgreSQL 错误参考

PostgreSQL 42P02:参数不存在

SQL 中包含 $1 风格的占位符,但没有绑定参数值,这通常是因为直接运行了驱动 SQL,或占位符出现在引号内。

SQLSTATE
42P02
名称
undefined_parameter
类别
语法错误或访问规则违规
错误信息
there is no parameter $1

它的意思

PostgreSQL 自己的占位符是 $1, $2 等等,会在语句预编译或以绑定参数执行时填充进去。如果文本中包含 $1 但语句发送时没有带参数,PostgreSQL 没有东西可替换,就会以 42P02(undefined_parameter).

这通常意味着从应用程序代码或日志中复制的 SQL 是手动运行的,或者驱动程序通过不绑定它们的路径发送了带占位符的查询字符串。

常见原因

  • 在 psql 或 SQL 编辑器中运行从代码或日志中复制的参数化查询。
  • 字符串内或美元引号包裹的函数体内的占位符,驱动程序不会替换它们。
  • A DO 块,或者写成动态 SQL,用 $1 无 EXECUTE ... USING.
  • 混合驱动程序占位符样式: ? 或者 %s 在一个地方, $1 在另一个地方。

如何修复它

  1. 手动运行时,用字面值替换占位符,或使用 PREPARE 和 EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. 在 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;
    $$;
  3. 在应用程序代码中,通过驱动程序的参数 API 传递值,而不是将它们拼接起来。

安全地复现它

SELECT $1;  -- ERROR: there is no parameter $1

相关错误

更多语法错误或访问规则违例错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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