HV00B — fdw_invalid_handle

PostgreSQL SQLSTATE HV00B 表示 FDW 或 SQL/MED 边界收到无效句柄；实际句柄的所有者与生命周期取决于已安装的包装器。

速览

HV00B 表示 FDW 包装器收到的句柄未知、已关闭，或对当前操作无效。对 PostgreSQL 18.6 核心与 contrib 调用的扫描没有解析出直接的 HV00B 报告组，因此句柄类型和具体消息取决于实现。

SQL/MED 中的“句柄”是实现自己管理的引用，不是 PostgreSQL 关系 OID 或 SQL 事务 ID。包装器可能用句柄表示远端连接、游标、回复或执行对象；这些只是可能的例子，本批没有确认具体的发码包装器。仅凭类别定义无法判断具体是哪一种。

在已检查的 18.6 核心与 contrib 路径中没有解析出直接的消息变体。应记录包装器名称和版本、句柄种类及生命周期、回调阶段、外部服务器和外部表，以及完整诊断信息。远端连接失败也可能使用其他 SQLSTATE。

沿包装器源码追踪句柄的创建、传递、复用和关闭。检查扫描或修改回调是否晚于连接销毁，回调是否在清理后运行，以及包装器 ABI 是否与服务器匹配。不要把 NULL SQL 值推断为无效句柄。

按包装器 API 修复句柄生命周期，或重新建立包装器管理的连接或对象。如果无法确定写操作是否已经完成，应先查看远端日志再决定是否重试。重复提交相同请求通常不能修复陈旧或已关闭的句柄。

HV00B 从 9.1.0 到 18.6 以及 19 Beta 3 均存在。可用的 9.1 之前定义扫描没有观察到它；这只是历史边界，不是精确的引入版本结论。

HV00K 涉及回复句柄；HV009 涉及无效空指针使用；HV00N 涉及建立连接。

errcodes.txt — 定义，SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba。
fdwapi.h — 回调边界。
结构化证据 — 有界源码扫描。