SAXParseException 是 Java 解析 XML 时因 XML 语法不合法（如标签未闭合、属性值未加引号、根元素缺失、非法字符未转义等）而抛出的检查型异常。

SAXParseException 是 Java 解析 XML 时抛出的检查型异常，说明 XML 文档在语法层面不合法——不是内容逻辑错，是根本“读不下去”。

XML 格式不合法的典型表现

常见错误现象包括：标签没闭合、属性值没加引号、根元素缺失、非法字符（如未转义的 & 或 ）、编码声明与实际不符等。JDK 自带的 SAX 解析器（<code>SAXParser）在遇到这些时，会立刻中断解析并抛出 SAXParseException，附带行号、列号和简短描述。

使用场景多见于配置文件加载、第三方 XML 接口响应解析、或对用户上传 XML 做前置校验。

• 错误信息里 lineNumber 和 columnNumber 很关键，但注意：它们指向的是解析器“卡住”的位置，不一定是问题源头（比如漏闭合的 <tag></tag> 可能导致后续几十行都报错）
• 如果 XML 来自网络或文件流，记得确保输入源编码与文档声明一致（如声明了 encoding="UTF-8"，但实际是 GBK 字节流，也会触发此异常）
• 某些编辑器自动补全的 XML 片段（如只写 <user name="a"></user> 不写 ）在粘贴进代码后极易引发该异常

捕获和定位 SAXParseException 的实操要点

不能只用 catch (Exception e) 吞掉它——必须显式捕获 SAXParseException，才能拿到精确位置信息。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

立即学习“Java免费学习笔记（深入）”；

示例片段：

try {
    saxParser.parse(inputStream, handler);
} catch (SAXParseException e) {
    System.err.printf("XML parse error at line %d, column %d: %s%n",
        e.getLineNumber(), e.getColumnNumber(), e.getMessage());
}

• 务必在 catch 块中调用 e.getLineNumber() 和 e.getColumnNumber()，别依赖堆栈日志——它们常被包装层吃掉
• 如果解析前已知 XML 来源不可信，建议先用 XMLReader 设置 setFeature("http://xml.org/sax/features/validation", false) 关闭 DTD 验证（避免因外部 DTD 加载失败误报）
• 不要在生产环境把原始异常信息直接返回给前端——行号列号对调用方无意义，还可能暴露路径或结构

和 ParserConfigurationException、SAXException 的区别

SAXParseException 专指“XML 内容本身格式错误”，而其他异常指向不同环节：

• ParserConfigurationException：创建 SAXParser 时参数非法（如要求命名空间但底层不支持）
• SAXException：更宽泛的解析过程异常，比如 ContentHandler 回调里主动 throw 的异常，或解析器内部状态错乱
• 三者都是 Exception 子类，但只有 SAXParseException 提供 getLineNumber() 等定位方法

真正难处理的往往是嵌套在 CDATA 或注释里的非法字符，解析器默认跳过它们，但一旦开启 http://xml.org/sax/features/resolve-dtd 或使用自定义 EntityResolver，就可能意外触发校验——这点容易被忽略。