2200S — invalid_xml_comment

XML 注释无效，含 -- 或以 - 结尾。

英文手册覆盖始于 PostgreSQL 8.1. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

8.3 8.4 9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19 20

aliases: 未知
class name: Data Exception
condition name: invalid_xml_comment
lang: en
sqlstate: 2200S

版本定义 PG 18

2200S

速览 {#at-a-glance}

XML 注释无效。PostgreSQL 18.6 的 xmlcomment 路径在注释文本含有被禁止的 -- 序列或以 - 结尾时报告 invalid XML comment；周围源码检查的是注释专属的 XML 语法，而不是一般文档失败。

含义 {#meaning}

本成员专用于 XML 注释语法，不涵盖所有 XML 文档失败。在 USE_LIBXML 下，xmlcomment 在构造 `` 之前扫描输入；任意位置的双连字符或末尾连字符都会被拒绝。

报文 {#messages}

该 guard 以 ERROR 严重性报告 primary：invalid XML comment。引用分支没有独立 DETAIL 或 HINT。未启用 USE_LIBXML 时函数走独立的 XML 支持路径（0A000），因此源码存在本身不能证明所有服务器构建都提供此功能。

诊断 {#diagnosis}

检查报文指出的注释文本和 XML 上下文。XML 注释不能包含被禁止的双连字符形式，也不能以连字符结尾；在保留周围标记的前提下修正该注释。若解析器实际指出处理指令或非文档内容，应按报出的 2200T 或 2200L/N 处理。

处理 {#response}

在保留周围 XML 的前提下修正注释文本，依据注释专属报文处理，而不是套用一般文档修复。

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

版本 {#versions}

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

来源 {#sources}

固定源码：src/backend/utils/adt/xml.c#L490-523。结构化证据记录保留完整注释 guard、报文和范围边界。违规注释是运行时输入，函数编译受 USE_LIBXML 控制；本页未运行自然 XML 案例。

比较版本

SQLSTATE 证据与已记录的运行版本

claims · identity

{
  "claim_id": "identity",
  "limits": "",
  "method": "Read fixed definition.",
  "position": 0,
  "runtime": [],
  "sources": [
    "src.errcodes.18.6"
  ],
  "statement": "2200S is invalid_xml_comment in SQLSTATE Class 22."
}

claims · mechanism.comment

{
  "claim_id": "mechanism.comment",
  "limits": "The branch is guarded by USE_LIBXML; without XML support the function follows the separate 0A000 path.",
  "method": "Read the complete comment validation loop.",
  "position": 1,
  "runtime": [],
  "sources": [
    "src.path.xml-comment"
  ],
  "statement": "xmlcomment rejects a comment containing -- or ending in - and emits 2200S with invalid XML comment."
}

claims · history

{
  "claim_id": "history",
  "limits": "",
  "method": "Use catalogue boundary.",
  "position": 2,
  "runtime": [],
  "sources": [
    "src.errcodes.18.6"
  ],
  "statement": "The locked catalogue records 2200S from 8.3.0 without proving an exact implementation introduction date."
}

messages · message.comment

{
  "limits": "",
  "message_id": "message.comment",
  "path": "",
  "position": 0,
  "raw": {
    "id": "message.comment",
    "primary_template": "invalid XML comment",
    "severity_source": "ERROR",
    "sources": [
      "src.path.xml-comment"
    ],
    "sqlstate": "2200S"
  },
  "severity": "ERROR",
  "sources": [
    "src.path.xml-comment"
  ],
  "templates": [
    {
      "kind": "primary",
      "literal": "invalid XML comment",
      "position": 0,
      "role": "",
      "template": "invalid XML comment"
    }
  ]
}

sources · src.errcodes.18.6

{
  "commit": "724edf9bde9d356724ad384a2e196edc3c9f80f7",
  "docs_url": "",
  "kind": "upstream_source",
  "location": "",
  "path": "src/backend/utils/errcodes.txt",
  "position": 0,
  "sha256": "6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba",
  "source_id": "src.errcodes.18.6",
  "tag": "REL_18_6",
  "url": "https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt#L213"
}

sources · src.calls.REL_18_6

{
  "commit": "",
  "docs_url": "",
  "kind": "local_artifact",
  "location": "",
  "path": "raw/calls/REL_18_6.jsonl",
  "position": 1,
  "sha256": "9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf",
  "source_id": "src.calls.REL_18_6",
  "tag": "",
  "url": ""
}

sources · src.path.xml-comment

{
  "commit": "724edf9bde9d356724ad384a2e196edc3c9f80f7",
  "docs_url": "",
  "kind": "upstream_source",
  "location": "",
  "path": "src/backend/utils/adt/xml.c",
  "position": 2,
  "sha256": "f1c70b5ee5ee9a20a41d9b2c27bc7a8a50dbd47d9489ba462a4a678f7f55f14d",
  "source_id": "src.path.xml-comment",
  "tag": "REL_18_6",
  "url": "https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/xml.c#L490-L523"
}

来源引用

原始手册引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · english-manuals:b7f8e9bf8321e83c287af3e9ca8831557bb4033e6f15b94ccfd0411ce9be8a5c

正文语言: zh-Hans · english-manuals:b7f8e9bf8321e83c287af3e9ca8831557bb4033e6f15b94ccfd0411ce9be8a5c