# 2200L — not_an_xml_document

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

# 2200L

## 速览 {#at-a-glance}
SQL/XML 的 `SQLSERIALIZE` `DOCUMENT` 操作收到的输入无法满足所要求的文档形式。PostgreSQL 18.6 会把这个公开的 DOCUMENT 路径映射到带有 `XMLOPTION_DOCUMENT` 的 `xmltotext_with_options`；失败或软错误会被映射为 `not an XML document`。包装器对非 DOCUMENT 且不缩进的提前绕过不属于 CONTENT 模式的 2200L 结论，本页也不涵盖所有 XML 内容或注释违规。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `2200L` |
| 条件名 | `not_an_xml_document` |
| 状态 | `有效` |
| 已知存在于 | `8.3.0` |
| 锁定快照 | `9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3` |
| 宏 | `ERRCODE_NOT_AN_XML_DOCUMENT` |
| 别名 | `—` |

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

## 含义 {#meaning}
本成员是公开 SQL/XML `SQLSERIALIZE` `DOCUMENT` 形式的文档级 XML 失败。该操作把 `XMLOPTION_DOCUMENT` 传给 `xmltotext_with_options`；后者用 `ErrorSaveContext` 调用 `xml_parse`，没有返回文档或保存的解析错误被设置时，就释放部分文档并报告 2200L。它的提前 guard 会在非 DOCUMENT 且不缩进时直接返回二进制兼容的输入，因此不能把这个映射推广到 `CONTENT`。较低层的 `xml_parse` 另有 2200M/2200N 分支，因此不能把本码理解为所有解析器错误的同义词。

## 报文 {#messages}

SQLSERIALIZE `DOCUMENT` 包装器以 `ERROR` 严重性报告 primary：`not an XML document`。引用分支没有独立 DETAIL 或 HINT；解析器的具体上下文须以实际运行报文和构建为准。

## 诊断 {#diagnosis}
保留完整上下文和传给 SQLSERIALIZE 的表达式。先确认操作要求的是 `DOCUMENT` 还是 `CONTENT`，再检查文档边界、顶层结构和编码。2200L 诊断只绑定上述 `DOCUMENT` 映射；不要从 `CONTENT` 请求推断本码，也不要把成员码 2200M/N/S/T 与本码的文档级条件混为一谈。

## 处理 {#response}
按解析器指出的位置修正文档边界和结构，同时保留调用方要求“文档”还是“片段”的语义要求。

该分支抛出 `ERROR` 时，显式事务应先用 `ROLLBACK` 恢复，或对语句前已建立的保存点执行 `ROLLBACK TO SAVEPOINT`，再重试；自动提交下只在失败语句结束后重试修正后的动作。事务边界规则见[事务与重试指南](../guides/)。

## 版本 {#versions}
锁定目录从 8.3.0 起记录该条件；固定源码覆盖 PostgreSQL 18.6。

## 相关 {#related}
[`2200M`](../2200m/)、[`2200N`](../2200n/)、[`2200S`](../2200s/)、[`2200T`](../2200t/)

## 来源 {#sources}
固定源码：[`src/backend/utils/adt/xml.c#L669-697`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/xml.c#L669-L697)。结构化[证据记录](../../data/evidence/2200l.json)保留文档选项 guard、报文和范围边界。源码确认了包装器映射；具体输入和可能的 libxml2 上下文取决于运行时。本页未运行自然 XML 案例。