PostgreSQL的xml_is_well_formed函数怎么用

月夜之吻 2025-12-27 00:00:00 次阅读

xml_is_well_formed只接受text类型输入，用于快速校验XML字符串是否符合基础Well-Formed规则，不解析结构、不支持xml类型参数，也不做DTD/XSD验证。

xml_is_well_formed 只接受 text 类型输入，不能直接传 XML 值

xml_is_well_formed 是 PostgreSQL 提供的纯文本校验函数，它不解析 XML 结构，也不做 DTD 或 Schema 验证，只检查字符串是否符合基础的 Well-Formed 规则（比如标签闭合、嵌套合法、字符转义正确等）。关键点是：它**只接受 text 参数，不接受 xml 类型值**。如果你传入一个已成功转换为 xml 类型的值（比如用 XMLPARSE 构造的），会报错：function xml_is_well_formed(xml) does not exist。

✅ 正确用法：xml_is_well_formed('ok')
❌ 错误用法：xml_is_well_formed(XMLPARSE(CONTENT '...'))
⚠️ 注意：即使字符串里有 BOM（如 UTF-8 BOM \xEF\xBB\xBF），也会导致返回 false

常见校验失败原因：空字符串、null、编码问题、非法字符

该函数对输入非常敏感，以下情况都会返回 false：

输入为 NULL → 返回 NULL（不是 false，注意三值逻辑）
空字符串 '' → 返回 false
含不可见控制字符（如 \x00、\x01～\x08、\x0B、\x0C、\x0E～\x1F）→ 返回 false
UTF-8 编码错误（如截断的多字节序列）→ 返回 false
XML 声明中指定了不支持的编码（如 encoding="ISO-8859-1" 但内容实际是 UTF-8）→ 返回 false

所以实际使用时建议先用 length() 和 convert_from() 粗筛，再调用 xml_is_well_formed。

和 XMLPARSE 的关系：校验 ≠ 解析，两者要配合用

xml_is_well_formed 快但浅，XMLPARSE 慢但深。前者适合在 INSERT/UPDATE 前快速过滤明显坏数据；后者才真正构建 XML 树并报详细错误（比如“mismatched tag”）。典型组合用法：

SELECT 
  data,
  xml_is_well_formed(data) AS is_wf,
  CASE 
    WHEN xml_is_well_formed(data) THEN XMLPARSE(CONTENT data)
    ELSE NULL 
  END AS parsed_xml
FROM (VALUES 
  ('test'),
  ('unclosed'),
  ('')
) AS t(data);