跳转到主要内容

42P02 — 未定义参数

PostgreSQL SQLSTATE 42P02（undefined_parameter）的来源与诊断参考。

42P02 — 未定义参数

速览

42P02（undefined_parameter）是解析阶段的 ERROR：$1 等位置参数超出了解析器已知的参数集合。它不同于 Bind 报文参数数量违反协议时的 08P01，也不同于参数存在但类型推导不一致的 42P08。

字段 值
SQLSTATE 42P02
条件名 undefined_parameter
状态 有效
已知存在于 7.4
锁定快照 9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3
宏 ERRCODE_UNDEFINED_PARAMETER
别名 —

含义

固定参数钩子会拒绝超出声明数组或类型无效的参数编号；可变参数钩子虽然会在解析时扩展数组，解析结束时仍会拒绝超出范围的参数。没有钩子解析该标记时也使用相同主消息。选定路径都带解析位置，there is no parameter $%d 中的编号是动态值；这针对 SQL 参数标记，不是表列或 PL/pgSQL 变量缺失。

扩展查询的边界不同：exec_bind_message 会检查参数格式码数量、参数值数量和预备语句的要求，数量不符时报告 08P01，例如 bind message supplies %d parameters, but prepared statement "%s" requires %d。因此 Bind 阶段的数量/格式错误不能改标成 42P02。

诊断

记录 SQL 文本、解析位置、参数编号和协议阶段。Parse/解析阶段对照固定或可变参数声明与每个 $n；扩展查询 Bind 阶段另查格式码和参数值数量，数量不符走 08P01。参数存在但类型推导冲突时才看 42P08。

处理

修正 SQL 占位符编号或 Parse 参数声明；Bind 阶段发送预备语句要求的准确参数数量和兼容的格式码，不要用类型转换掩盖数量错误。真正缺少参数时补上预期参数，或明确改用字面量/默认值。若 ERROR 发生在显式事务中，应回滚到合适保存点或回滚事务后重试；本页没有运行时恢复观察。

消息变体

选定解析路径均为 ERROR there is no parameter $%d；%d 是动态参数编号。固定的 18.6 Bind 检查属于 08P01，主消息是 bind message has %d parameter formats but %d parameters 或 bind message supplies %d parameters, but prepared statement "%s" requires %d。

版本

目录锁定范围从 7.4 下界到 18.6、19beta3；这是目录范围，不是运行时比较。选定的是 18.6 固定解析器和 Bind 源码路径，未运行客户端 Bind 案例。

来源

  • src.errcodes.42P02.18.6 — src/backend/utils/errcodes.txt line 375，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba（源码）。

  • src.call.42P02.81f0048a16f439569ce3a4ba — src/backend/parser/parse_expr.c lines 899-902，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 63c37770872a08978f931c31f801666a08e3bc8e51c2c65ff60151a1d139d55b（源码）。

  • src.call.42P02.73515542f469d69893fd5fb8 — src/backend/parser/parse_param.c lines 109-112，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 4aab2ecc770fcda619b26ac12beaf7e527542b56f55eb45879b72e92442e8a28（源码）。

  • src.call.42P02.671f865f9d428e0ab2a78347 — src/backend/parser/parse_param.c lines 203-206，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 4aab2ecc770fcda619b26ac12beaf7e527542b56f55eb45879b72e92442e8a28（源码）。

  • src.call.42P02.bind-contract — src/backend/tcop/postgres.c lines 1718-1731，固定于 724edf9bde9d356724ad384a2e196edc3c9f80f7；SHA-256 9fb62275b1badf94d01ab351337b60410cd9b3ab1fe63fa9f23d6d2185a21061（源码）。

  • src.calls.REL_18_6.42P02 — 固定本地核心调用扫描；SHA-256 9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf。

  • 作者证据 — 记录源码断言、消息角色和运行边界。