HV009 fdw_invalid_use_of_null_pointer

外部数据包装器非法使用空指针

ERROR 仅定义参考未实测

版本覆盖

HV009 描述 FDW 边界的非法空指针使用。18.6 核心/contrib 调用扫描没有直接报告组，因此没有安全的 SQL 复现或自带报文。

它用于包装器/API 契约中的空指针问题，例如包装器把缺少的描述符、handle 或回调结果当成存在。它不是普通 SQL NULL 值错误，不能从可空列推断。

没有固定核心报文。保留拥有该指针的回调、handle/描述符、包装器构建版本和服务器日志；实现不同也可能表现为崩溃、XX000 或驱动异常。

在源码证明前，把它按包装器缺陷或契约/ABI 不匹配处理。检查回调实现和版本，确认远端断开或分配失败是否制造了空状态；不要从 SQL 侧解引用或修复对象。

包装器缺陷存在时不要继续重试。保留日志，在一次性环境隔离外部表/服务器，确认后升级或修补包装器；若进程或连接已终止，按相应组件的恢复流程处理。

目录从 9.1.0 观察到该码，延续到 18.6 与 19 Beta 3；pre-9 定义扫描未观察到，精确实现引入未知。

每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。

HV009 is fdw_invalid_use_of_null_pointer in Class HV.

核实方式Read the fixed definition row.

来源src/backend/utils/errcodes.txt
No direct HV009 report group was resolved in the locked PostgreSQL 18.6 core/contrib call scan.

核实方式Compare resolved report groups with the macro mapping.

不覆盖A wrapper may terminate the connection or process instead of returning this code. Generic API context and the absent resolved report group do not establish a source path emitting this SQLSTATE.

来源raw/calls/REL_18_6.jsonl · src/include/foreign/fdwapi.h