确保源XML格式良好，检查标签闭合、属性引号及非法字符，避免解析失败。
在XSLT转换过程中遇到XML解析错误，通常不是因为XSLT逻辑本身的问题，而是源XML或样式表结构不符合规范。解决这类问题需要系统性地排查输入、语法和运行环境。以下是5个实用的调试技巧，帮助你快速定位并修复问题。
1. 确保源XML格式良好（Well-formed）
XML解析错误最常见的原因是源文档不“格式良好”。XSLT处理器在开始转换前必须能成功解析XML，否则直接报错。
- 检查是否有未闭合的标签，如
张三 而没有 - 确认所有属性值用引号包围，例如 class="item" 而非 class=item
- 避免使用非法字符，如裸露的 & 或
- 确保根元素唯一，且没有多个顶层节点
可用在线XML验证工具或编辑器（如VS Code、Oxygen XML）实时检测语法问题。
2. 验证XSLT样式表本身是否格式良好
XSLT本身也是XML，因此同样需要格式良好。一个拼写错误的标签就能导致整个转换失败。
- 检查 xsl:template、xsl:for-each 等标签是否正确闭合
- 确认命名空间声明正确，常见的是 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- 确保版本属性存在，如 version="1.0" 或 version="2.0"
- 避免在XSLT中直接插入未转义的XML片段
建议使用支持XSLT语法高亮的编辑器，能自动提示标签匹配问题。
3. 使用简单测试用例隔离问题
当面对复杂XML和XSLT时，缩小范围是关键。
- 创建一个极简的XML文件，只包含根节点和一个子元素
- 编写一个最简单的XSLT，仅输出文本或复制内容
- 逐步增加结构，直到错误重现，即可锁定出问题的部分
这种方法能快速判断问题是出在数据结构、命名空间还是模板匹配逻辑上。
4. 启用详细错误日志和行号信息
多数XSLT处理器（如Saxon、Xalan）支持输出详细的解析错误位置。
- 运行时添加 -t 参数（Saxon）查看处理流程
- 捕获异常时打印 stack trace，获取出错的行号
- 在Java或.NET环境中，启用调试模式以获得更完整的上下文
例如，错误信息“Invalid at line 12, column 5”能直接定位到XML中的某个字符。
5. 检查编码与BOM问题
字符编码不一致或存在隐藏的BOM（字节顺序标记）常引发解析失败。
- 确保XML和XSLT文件使用相同编码（推荐UTF-8）
- 查看文件开头是否有不可见的BOM字符（EF BB BF）
- 在XML声明中明确指定编码：
- 使用十六进制编辑器或命令行工具（如 file filename）检查实际编码
某些编辑器默认保存带BOM的UTF-8，而部分解析器无法正确处理。
基本上就这些。XSLT转换出错时，先从最基础的XML格式和编码入手，再逐步深入逻辑层面。问题往往出现在你以为“不可能错”的地方。保持耐心，逐层验证，大多数解析错误都能快速解决。
