文档 / SQL 状态码 / Class 0F 定位器异常
0F000 locator_exception
ERROR 仅定义 参考 未实测
- 条件名
locator_exception- 宏名称
ERRCODE_LOCATOR_EXCEPTION- 启用版本
- 7.4
- 状态
- 活跃
版本覆盖
速览
SQLSTATE 0F000 是 Locator Exception 类别码，不是一条具体的 locator 失败消息。PostgreSQL 18.6 定义中存在该代码，但锁定的 core/contrib 扫描没有解析出 0F000 报告调用组。客户端、嵌入式 SQL 层、扩展或远端实现仍可能暴露这一标准类别，因此必须先确认实际产生者，再采用 locator 相关处置。
含义
末三位为 000，所以 0F000 是类别级条件。它可以归拢 0F001 等 locator 成员，但自身不能指出具体句柄、描述符或 locator 操作。PostgreSQL 的定义行可用于分类，而固定扫描没有解析出原生报告边界。
消息
由于有界扫描没有解析出原生报告调用，本页不采用未经确认的 PostgreSQL 固定消息变体。
诊断
保留实际返回的成员 SQLSTATE，并记录客户端或服务器组件、操作以及 locator/描述符身份。在该组件的固定源码或协议映射中查找报告路径。不要从类别名称推断 locator 句柄，也不要把查询返回零行当成 locator exception。
处理
只有在实际产生者的文档支持时，才根据该组件指出的具体 locator 或描述符问题修正其生命周期、声明或引用对象。若结果来自远端转发，应保留远端错误并遵循其所有者的恢复规则。单凭该类别无法建立 PostgreSQL 原生重试规则。
版本
锁定目录将该条件的已知下界记为 PostgreSQL 7.4。事实块列出已发布快照；源码路径状态仅限于下方固定的 PostgreSQL 18.6 资料。
来源
- 上游源码 src/backend/utils/errcodes.txt 第 127 行
- 核验材料 raw/calls/REL_18_6.jsonl
证据
断言
每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。
-
0F000 is locator_exception in SQLSTATE Class 0F.
-
No resolved 0F000 report group was found in the locked PostgreSQL 18.6 core/contrib call scan.
-
The locked release definitions establish catalogue presence from the known 7.4 boundary; they do not establish a precise introducing release or runtime use.
同类 SQL 状态码
| 状态码 | 条件名 | 宏名称 | 严重等级 | 版本 |
|---|---|---|---|---|
| 0F000 | locator_exception | ERRCODE_LOCATOR_EXCEPTION |
ERROR | 7.4 |
| 定位器（locator）异常的类别条件。 | 活跃 | |||
| 0F001 | invalid_locator_specification | ERRCODE_L_E_INVALID_SPECIFICATION |
ERROR | 7.4 |
| 定位器规格无效的标准条件。 | 活跃 | |||