42P02 undefined_parameter

速览

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

含义

固定参数钩子会拒绝超出声明数组或类型无效的参数编号；可变参数钩子虽然会在解析时扩展数组，解析结束时仍会拒绝超出范围的参数。没有钩子解析该标记时也使用相同主消息。选定路径都带解析位置，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 案例。

相关

• 42P08
• 42P09
• 08P01
• 42601

来源

• 上游源码 src/backend/parser/parse_param.c 第 203–206 行 REL_18_6 724edf9bd 4aab2ecc
• 上游源码 src/backend/parser/parse_param.c 第 109–112 行 REL_18_6 724edf9bd 4aab2ecc
• 上游源码 src/backend/parser/parse_expr.c 第 899–902 行 REL_18_6 724edf9bd 63c37770
• 上游源码 src/backend/tcop/postgres.c 第 1718–1731 行 REL_18_6 724edf9bd 9fb62275
• 上游源码 src/backend/utils/errcodes.txt 第 375 行 REL_18_6 724edf9bd 6e8de346
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8