StAX解析比DOM快、比SAX易控，关键在于手动控制XMLStreamReader事件流：需用nextTag()跳过空白、skipChildren()跳过无关嵌套、IS_COALESCING设为false减内存压力，并在异常前立即获取getLocation()定位错误。
StAX解析比DOM快但比SAX难调？关键在XMLStreamReader的循环控制
StAX不是“自动解析器”，它把解析权交给你——每次调用 next() 或 nextEvent() 才推进一个事件。上传大XML时，DOM会直接OOM，SAX又得写一堆回调，而StAX能按需读取、及时释放引用，前提是别把所有START_ELEMENT都缓存成对象。
常见错误是：在while (reader.hasNext())里无条件next()，却没跳过文本节点或注释，导致解析错位；或者对每个START_ELEMENT都新建Element类实例，内存没省下来。
- 只在需要时调用
getElementText()，避免提前加载整个文本内容 - 用
getEventType() == XMLStreamConstants.START_ELEMENT判断，不用字符串比较标签名 - 遇到不需要的深层嵌套节点，用
skipChildren()快速跳过（JDK 8u60+ 支持）
上传流必须包装为InputStream，且禁用缓冲区自动关闭
Spring MVC 的 MultipartFile.getInputStream() 返回的是装饰过的流，底层可能依赖临时文件或内存缓冲。直接传给 XMLInputFactory.createXMLStreamReader(InputStream) 没问题，但千万别在 try-with-resources 里同时关流和 reader——XMLStreamReader 关闭时会尝试关底层流，而 MultipartFile 流被关会导致后续无法读取或抛 IllegalStateException。
- 显式创建
XMLInputFactory并设IS_COALESCING为 false（默认 true 会合并相邻文本节点，增加内存压力） - 不使用
Files.newInputStream()或new FileInputStream()，MultipartFile 已封装好生命周期 - reader 关闭后，让 Spring 自行清理 MultipartFile 资源（如配置了
StandardServletMultipartResolver）
XMLInputFactory factory = XMLInputFactory.newInstance(); factory.setProperty(XMLInputFactory.IS_COALESCING, Boolean.FALSE); XMLStreamReader reader = factory.createXMLStreamReader(multipartFile.getInputStream());
getAttributeValue() 和 getElementText() 的陷阱
这两个方法看着方便，但背后行为差异很大：getAttributeValue() 是安全的，只读当前事件属性；而 getElementText() 会自动消费后续事件直到匹配的 END_ELEMENT，如果结构不规整（比如缺少闭合标签），它会一路读到流末尾，导致后续逻辑失效。
立即学习“Java免费学习笔记（深入）”；
- 只在确认该元素是“纯文本叶节点”时用
getElementText()，否则手动循环读取CHARACTERS事件 - 获取属性优先用
getAttributeValue(null, "attrName")，第二个参数传null表示不校验命名空间，避免空指针 - 避免在循环中反复调用
hasNext()+next()，改用nextTag()跳过空白和注释，更稳定
流式解析失败时，错误位置难定位？靠getLocation()实时抓坐标
StAX 不像 DOM 那样报错就带完整路径，但它提供 XMLStreamReader.getLocation()，返回 Location 对象，含行号、列号、系统ID（通常是 unknown，但上传场景可设为文件名）。
这个信息必须在异常抛出前立刻获取，因为一旦 reader 状态改变（比如继续 next），位置就变了。很多人等 catch 住再查，结果拿到的是下一个事件的位置。
- 在关键解析点（如进入业务主节点前）记录
reader.getLocation().getLineNumber() - 自定义异常时，把
getLocation()结果作为构造参数传入，不要只记 message - 若需日志追踪，用
reader.getName().getLocalPart()补充当前元素名，比硬编码字符串可靠
try {
while (reader.hasNext()) {
int event = reader.next();
if (event == XMLStreamConstants.START_ELEMENT && "order".equals(reader.getLocalName())) {
Location loc = reader.getLocation();
// 记录位置，准备解析 order 内容
}
}
} catch (XMLStreamException e) {
Location loc = reader.getLocation(); // 此刻立即取
throw new XmlParseException("Parse failed at line " + loc.getLineNumber(), loc, e);
}
真正卡住性能的往往不是解析本身，而是把流式结果又塞进 ArrayList 或 Map 做二次处理。上传 XML 解析完就该转成领域对象并入库或发消息，别留着“待处理集合”占内存。 
