22035

速览

SQL/JSON path 没有找到请求的项。固定表达式执行路径报告 no SQL/JSON item found for specified path。

报文

ERROR 行为使用以下首要文本：

含义

JSON path 可以产生空结果而不立即抛错。JsonPathQuery 和 JsonPathValue 会把零匹配标记为 empty；随后 SQL/JSON 表达式执行器应用 ON EMPTY，如果没有单独的 ON EMPTY 行为，也会使用非 ERROR 的 ON ERROR 行为。只有有效行为是 ERROR 时，执行器才报告 22035，并根据是否有列名选择对应首要文本。jsonb_path_query_first 等辅助函数可以直接把无匹配返回为 NULL，因此 22035 不是所有空 path 结果的统称。

诊断

记录操作、path、列名以及 ON EMPTY/ON ERROR 子句。区分预期的 NULL/默认回退和会进入 22035 的 ERROR 行为。strict 与 lax 的 path 求值以及 silent 模式可能改变结构问题是变成空结果还是被抑制的求值错误；多项结果和无效下标分别使用 22034 与 22033。

处理

如果必须找到项，修正 path、输入文档或列映射；如果无匹配是允许的，则使用文档规定的 ON EMPTY 行为，或使用明确把无匹配返回 NULL/空结果的辅助函数。不要用 wrapper 解决无项问题，wrapper 处理的是多项基数。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的表达式。

版本

锁定目录从 12.0 起记录该条件；本页固定 SQL/JSON 执行器路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

相关

22033、22034

来源

JSON path 辅助函数在 src/backend/utils/adt/jsonpath_exec.c#L3880-4070 中标记空结果。SQL/JSON 的 ON EMPTY/ON ERROR 处理及两个 22035 首要文本见 src/backend/executor/execExprInterp.c#L4940-5080。结构化证据记录保留空结果与行为边界；本页未运行自然案例。