SAXParseException 是 Java 解析 XML 时因 XML 语法不合法（如标签未闭合、属性值未加引号、根元素缺失、非法字符未转义等）而抛出的检查型异常。
SAXParseException 是 Java 解析 XML 时抛出的检查型异常，说明 XML 文档在语法层面不合法——不是内容逻辑错，是根本“读不下去”。
XML 格式不合法的典型表现
常见错误现象包括：标签没闭合、属性值没加引号、根元素缺失、非法字符（如未转义的 & 或 ）、编码声明与实际不符等。JDK 自带的 SAX 解析器（SAXParser）在遇到这些时，会立刻中断解析并抛出 SAXParseException，附带行号、列号和简短描述。
使用场景多见于配置文件加载、第三方 XML 接口响应解析、或对用户上传 XML 做前置校验。
- 错误信息里
lineNumber和columnNumber很关键，但注意：它们指向的是解析器“卡住”的位置，不一定是问题源头（比如漏闭合的 - 如果 XML 来自网络或文件流，记得确保输入源编码与文档声明一致（如声明了
encoding="UTF-8"，但实际是 GBK 字节流，也会触发此异常） - 某些编辑器自动补全的 XML 片段（如只写
）在粘贴进代码后极易引发该异常
捕获和定位 SAXParseException 的实操要点
不能只用 catch (Exception e) 吞掉它——必须显式捕获 SAXParseException，才能拿到精确位置信息。
立即学习“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，就可能意外触发校验——这点容易被忽略。
