2200L

速览

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

含义

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

报文

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

诊断

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

处理

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

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

版本

锁定目录从 8.3.0 起记录该条件；固定源码覆盖 PostgreSQL 18.6。

相关

2200M、2200N、2200S、2200T

来源

固定源码：src/backend/utils/adt/xml.c#L669-697。结构化证据记录保留文档选项 guard、报文和范围边界。源码确认了包装器映射；具体输入和可能的 libxml2 上下文取决于运行时。本页未运行自然 XML 案例。