StaxEventItemReader 可流式读取大型 XML 文件，避免内存溢出，适用于结构扁平、重复标签（如 order）的场景；需配置 resource、fragmentRootElementName、unmarshaller 等，并确保 Java Bean 含正确 JAXB 注解。
Spring Batch 使用 StaxEventItemReader 可以高效、流式地读取大型 XML 文件，避免将整个文档加载到内存，适合处理结构清晰、重复标签的 XML 数据（如订单列表、用户清单等）。它基于 StAX（Streaming API for XML），底层使用 Woodstox 或 JDK 自带的 StAX 实现。
XML 结构需满足可映射前提
StaxEventItemReader 不解析任意嵌套 XML，它依赖“扁平化”的重复元素作为业务对象单位。例如：
<?xml version="1.0" encoding="UTF-8"?> <orders> <order id="1001"> <customerName>Alice</customerName> <amount>299.99</amount> </order> <order id="1002"> <customerName>Bob</customerName> <amount>149.50</amount> </order> </orders>其中每个 <order></order> 是一个独立 item，StaxEventItemReader 会逐个提取并映射为 Java 对象。
配置 StaxEventItemReader 的关键项
需指定资源路径、根标签名、映射 处理器（Unmarshaller）及命名空间（如有）：
- resource：XML 文件路径，支持
FileSystemResource、ClassPathResource等 - fragmentRootElementName：每个 item 对应的 XML 元素名（如
"order"） - unmarshaller：用
Jaxb2Marshaller将 XML 片段反序列化为 Java Bean（Bean 需加@XmlRootElement和字段级@XmlElement） - namespaceAware：设为
true若 XML 含命名空间（如xmlns="http://example.com/ns"），此时需在unmarshaller中注册 namespace handler 或使用@XmlSchema
写入 XML：用 StaxEventItemWriter
对应读取，StaxEventItemWriter 支持流式写入。需配置：
- resource：输出文件路径（如
FileSystemResource("output/orders.xml")） - rootTagName：外层容器标签名（如
"orders"） - marshaller：同样用
Jaxb2Marshaller，确保目标类有正确 JAXB 注解 - overwriteOutput：设为
true允许覆盖已有文件（默认 false，写入失败）
注意：它不会自动添加 XML 声明（<?xml version="1.0"?>），如需，可在 StaxEventItemWriter 初始化后调用 setXmlDeclaration(true)（Spring Batch 5+ 支持）。
常见问题 与建议
避免运行时异常的关键细节：
- 确保 XML 中每个 fragment 元素是合法、闭合的；含非法字符或未闭合标签会导致
XMLStreamException - Java Bean 字段名与 XML 标签名不一致时，用
@XmlElement(name = "customerName")显式指定 - 属性值（如
id="1001"）需用@XmlAttribute注解，不能用@XmlElement - 若 XML 含 CDATA 或特殊 编码，确认
InputStream指定正确 charset（如 UTF-8），并在Resource构造时传入
不复杂但容易忽略。
