XML 报错只说 “mismatched tag”?在浏览器里定位到具体行列号的思路

2 阅读2分钟

声明:我是 ToolKnit 的开发者,文末提到的工具是我做的。本文由 AI 辅助起草,代码和结论已人工核对。

前端偶尔还是得和 XML 打交道:SVG、RSS/Atom、sitemap、Android 资源文件,还有一些老接口返回的 SOAP。最烦的情况是一个几千行的 XML 只报一句 mismatched tag,得自己一行一行找。

用 DOMParser 做校验

浏览器自带的 DOMParser 就能做语法校验。解析失败时,它不会抛异常,而是返回一个包含 <parsererror> 节点的文档:

function validateXml(text) {
  const doc = new DOMParser().parseFromString(text, "application/xml");
  const err = doc.querySelector("parsererror");
  if (!err) return { ok: true, doc };
  const msg = err.textContent || "";
  // Chrome / Firefox 的错误文本里通常带有行号、列号
  const m = msg.match(/line\s*(?:number\s*)?(\d+).*?column\s*(\d+)/i);
  return { ok: false, message: msg.trim(), line: m && +m[1], column: m && +m[2] };
}

需要注意:

  • 各浏览器的错误文本格式不一样,正则要写得宽松一些,匹配失败时退回显示原文。
  • MIME 要用 application/xml。用 text/html 会被 HTML 解析器“宽容”掉,很多错误根本报不出来。
  • 拿到行列号以后,在编辑器里高亮那一行,比弹一个错误框有用得多。

格式化的几个坑

  1. xml:space="preserve" 和混合内容。 <p>Hello <b>world</b></p> 这类文本和标签混在一起的节点,盲目换行缩进会改变文本内容。
  2. CDATA 和注释要原样保留,不要重新缩进里面的内容。
  3. 声明与处理指令(<?xml ...?>、<?xml-stylesheet ...?>)要放在最前面,不能被重排。
  4. 压缩(minify)时只删除标签之间的纯空白,不要动文本节点里的空格。

缩进一般给用户三种选择:2 空格、4 空格、Tab。不同团队习惯不同,不要替用户定死。

为什么坚持本地处理

需要格式化的 XML 经常是接口返回的真实数据、内部配置或客户的 sitemap。把这些内容粘到一个会上传服务器的在线工具里,风险不小。上面这套 DOMParser 加字符串处理的方案完全可以在浏览器里完成,没有必要上传。

现成工具

我把上面的思路做成了 XML 在线格式化与语法校验:

  • 格式化、美化、单行压缩,缩进可选 2 空格 / 4 空格 / Tab
  • 精确定位未闭合标签所在的行号和列号
  • 支持导入、导出 .xml / .svg / .rss
  • 全程在浏览器本地运行,不上传

它属于这次一起上线的 7 个本地小工具,其余几个(PNG 转多尺寸 ICO、二维码本地解码、ZIP 打包等)可以在 ToolKnit 首页 找到。你平时处理 XML 还踩过哪些坑,欢迎在评论区补充。