# 22035 — no_sql_json_item

> PostgreSQL SQLSTATE 22035 的来源与诊断参考。
---

# 22035

## 速览 {#at-a-glance}
SQL/JSON path 没有找到请求的项。固定表达式执行路径报告 `no SQL/JSON item found for specified path`。

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `22035` |
| 条件名 | `no_sql_json_item` |
| 状态 | `有效` |
| 已知存在于 | `12.0` |
| 锁定快照 | `12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3` |
| 宏 | `ERRCODE_NO_SQL_JSON_ITEM` |
| 别名 | `—` |

<!-- source facts: data/errcodes/22035.json -->
<!-- END SQLSTATE FACTS -->

## 报文 {#messages}
ERROR 行为使用以下首要文本：

| 上下文 | 首要文本 |
| --- | --- |
| 有名的 JSON_TABLE/SQL/JSON 列 | `no SQL/JSON item found for specified path of column "%s"` |
| 没有列名 | `no SQL/JSON item found for specified path` |

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

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

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

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

## 相关 {#related}
[`22033`](../22033/)、[`22034`](../22034/)

## 来源 {#sources}
JSON path 辅助函数在 [`src/backend/utils/adt/jsonpath_exec.c#L3880-4070`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/jsonpath_exec.c#L3880) 中标记空结果。SQL/JSON 的 ON EMPTY/ON ERROR 处理及两个 22035 首要文本见 [`src/backend/executor/execExprInterp.c#L4940-5080`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/executor/execExprInterp.c#L4940)。结构化[证据记录](../../data/evidence/22035.json)保留空结果与行为边界；本页未运行自然案例。