42P14 — 无效预备语句定义
PostgreSQL SQLSTATE 42P14：来源与诊断参考。
42P14 — 无效预备语句定义
速览
42P14（invalid_prepared_statement_definition）PREPARE 命令可能在定义预备语句时失败。
| 字段 | 值 |
|---|---|
| SQLSTATE | 42P14 |
| 条件名 | invalid_prepared_statement_definition |
| 状态 | 有效 |
| 已知存在于 | 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_INVALID_PSTATEMENT_DEFINITION |
| 别名 | — |
含义
固定的 18.6 PrepareQuery 路径在注册命名预备语句前，拒绝 SQL PREPARE 的空名称或空指针；这是因为扩展协议有独立的 unnamed 语句槽。因此，协议 Parse 消息中的空名称不自动等于 42P14，空的 SQL 引用标识符也可能先在词法或解析阶段失败。
诊断
准确记录客户端发送的是 SQL PREPARE 还是扩展协议 Parse，并保留语句名。区分 SQL PREPARE 的空名称检查、合法的协议 unnamed 语句、26000（预备语句不存在）以及后续参数/类型错误；空的引用标识符可能在到达此 guard 前就失败。
处理
SQL PREPARE 应使用非空且引用方式一致的语句名。扩展协议若本来要使用 unnamed 语句槽，就保留该协议语义，不要改写成 SQL PREPARE。若名称由框架生成，检查命名层，并确认后续 EXECUTE 与 DEALLOCATE 使用同一会话。显式事务中的 ERROR 之后，下一条命令前仍需 ROLLBACK 或回滚到错误前的保存点。
消息
固定源码中的代表性消息为：invalid statement name: must not be empty（ERROR；没有占位符）。
版本
锁定目录显示该条件最早见于 PostgreSQL 7.4；行为说明固定在 PostgreSQL 18.6 源码，目录存在范围不等于每条消息或功能都从该版本开始。
相关
来源
源码消息、行号和证据边界见 作者证据。
src/backend/commands/prepare.c:73-75(fixed source)src/backend/tcop/postgres.c:1433-1459(fixed source)